Technical FAQ

Register an account and request an API key from the AhoraCrypto team. The Payment Intent API additionally requires a storeId, which is unique per client and is also provided by AhoraCrypto.

All API endpoints are served from https://api.ahoracrypto.com.

Every request must include the x-api-key header with your API key. Requests without a valid key return 401 Unauthorized.

See the Networks page for the full list. Always use the network symbol exactly as listed there as the value of the network field.

Either one. When creating a Payment Intent you define the crypto amount or the fiat amount, and the system calculates the other. If both are sent, the fiat amount takes priority and the crypto amount is recalculated.

Only when the Payment Intent status is 4 (Ready to pay). While the status is not ready (for example, a KYC validation is pending) the instructions endpoint cannot be called. Check the status at any time with the status endpoint.

Provide an ipnUrl when creating the Payment Intent. It is called via GET with the paymentIntentId and paymentIntentStatus parameters whenever the status changes. You can also poll the status endpoint at any time.

Yes. If a user must complete KYC before purchasing, the create call returns a kycUrl where they can finish the verification. Provide a kycCallbackUrl to bring the user back into your flow once KYC is done.

The IP address is part of the data sent to payment gateways, which require it to verify the authenticity of the transaction. Any data you provide, such as the country, must be accurate and never inferred from other data points. If a value is unknown, omit it.

Yes. Use the official React SDK (ahoracrypto-react-sdk), which also supports Capacitor for building iOS and Android apps. For plain web pages, use the Web Widget.