Payment Intent API

The Payment Intent API allows users to purchase crypto using fiat currency (e.g., buy USDT by paying in EUR). Payments are made via bank transfer.

Once the payment is completed, the purchased crypto is sent to the wallet specified during order registration.

The API also supports KYC verification for new users if required.

Create a new Payment Intent

This method allow to register a new payment intent.

A Payment Intent records a user's intent to purchase a specified amount of crypto and pay for it using fiat. Either the crypto amount or the fiat amount is defined during the creation of the Payment Intent.

For example, if a user wants to buy €1000 worth of BTC, the system will automatically calculate the corresponding BTC amount. Similarly, if the user wants to purchase 0.01 BTC, the system will determine the required fiat amount to complete the purchase.

Therefore, it is not necessary to provide both values. If both the crypto and fiat amounts are sent via the API, the system will prioritize the fiat amount and recalculate the crypto amount accordingly.

The fiat or crypto amounts calculated by the system can be retrieved through the payment instructions API call. This allows users to review and confirm the final amounts before proceeding with the payment.

If the user is required to complete the KYC process before purchasing crypto, this API call will return a URL where they can complete the verification. Additionally, a callback URL can be specified so that, once the KYC process is successfully completed, the user is redirected back to continue the purchase process.

The API call will return three values:

1. A Payment Intent ID to reference in subsequent API calls.

2. A status:

   • 2 if the user needs to complete the KYC process.

   • 3 if everything is ready for payment.

   • 4 if the user started the KYC process but need to be verified manually.

3. A KYC URL (if required) where the user can complete the verification process.

To call the API, it is essential to include the x-api-key header.

Additionally, the storeId value, which is unique per client, must be specified for the API request to function correctly.

Both values are provided by AhoraCrypto.

post

Header parameters

x-api-keystringrequired

API key for authentication

Body

phonePrefixstringrequired

Country calling code (e.g., +1, +44)

phoneNumberstringrequired

User phone number without country code

emailstringrequired

User email address

fiatCurrencystringrequired

Fiat currency code (e.g., USD, EUR)

cryptoSymbolstringrequired

Cryptocurrency symbol (e.g., USDT, BTC)

ipAddressstringrequired

User IP address

countrystringrequired

ISO country code (2 characters, e.g., ES for Spain, US for United States, ...)

walletAddressstringrequired

Cryptocurrency wallet address

networkstringrequired

Blockchain network for the transaction

storeIdstringrequired

Unique identifier assigned by the API provider. Contact support to get your store ID.

cryptoAmountnumberoptional

Amount in cryptocurrency to be received. If not specified, the fiat amount will be used to calculate the crypto amount.

fiatAmountnumberoptional

Amount in fiat currency to be paid. If not specified, the crypto amount will be used to calculate the necessary fiat amount to be paid.

kycCallbackUrlstringoptional

URL to redirect the user after KYC verification is done in case the user has to pass the KYC verification

paymentCallbackUrlstringoptional

URL to redirect the user after payment completion or cancellation

ipnUrlstringoptional

URL where payment status notifications (IPN) will be sent

firstNamestringoptional

User first name

lastNamestringoptional

User last name

documentTypenumberoptional

Type of identification document

documentNumberstringoptional

Identification document number

birthDatestringoptional

User birth date in YYYY-MM-DD format

documentIssuedCountrystringoptional

ISO country code of document issuance (2 characters, e.g., ES for Spain, US for United States, ...)

nationalitystringoptional

ISO country code for nationality (2 characters, e.g., ES for Spain, US for United States, ...)

kycVideoUrlstringoptional

URL of KYC verification video

documentFrontUrlstringoptional

URL of identification document front image

documentBackUrlstringoptional

URL of identification document back image

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://ahoracrypto.com/payment/intent' \
  --header 'x-api-key: text' \
  --header 'Content-Type: application/json' \
  --data '{
    "phonePrefix": "text",
    "phoneNumber": "text",
    "email": "text",
    "fiatCurrency": "text",
    "cryptoSymbol": "text",
    "ipAddress": "text",
    "country": "text",
    "walletAddress": "text",
    "network": "text",
    "storeId": "text",
    "cryptoAmount": 1,
    "fiatAmount": 1,
    "kycCallbackUrl": "text",
    "paymentCallbackUrl": "text",
    "ipnUrl": "text",
    "firstName": "text",
    "lastName": "text",
    "documentType": 1,
    "documentNumber": "text",
    "birthDate": "text",
    "documentIssuedCountry": "text",
    "nationality": "text",
    "kycVideoUrl": "text",
    "documentFrontUrl": "text",
    "documentBackUrl": "text"
  }'

200

400

401

500

200

{
  "id": "text",
  "status": 1,
  "kycUrl": "text"
}

Create payment intent

Get Payment Instructions

Once the Payment Intent has been registered and the payment is ready—either because the returned status was 3 (Ready for Payment) or the user has successfully completed the KYC process

To call the API, it is essential to include the x-api-key header.

We can retrieve the payment instructions by calling the following method:

get

Path parameters

idstringrequired

Header parameters

x-api-keystringrequired

API key for authentication

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://ahoracrypto.com/payment/intent/{id}/instructions' \
  --header 'x-api-key: text'

200

401

403

404

500

200

{
  "iban": "text",
  "bic": "text",
  "accountHolder": "text",
  "bankCountry": "text",
  "reference": "text",
  "fiatAmount": 1,
  "fiatCurrency": "text",
  "cryptoAmount": 1,
  "cryptoCurrency": "text",
  "walletAddress": "text",
  "network": "text",
  "creditCardPaymentUrl": "https://example.com"
}

Get payment instructions

Get Payment Status

At any time, we can check the status of a payment using this call.

Posible values are:

• 1 Pending to pay

• 2 Pending to pass the KYC. Order can't be processed until the user has passed the KYC

• 4 Pending to pass a manual KYC verification. User has upload its documents to KYC center, but still need to be verified manually by AhoraCrypto.

• 6 Fully processed

• 12 Fully refunded

• 14 Fully cancelled

• 21 Waiting payment via bank transfer

• 10000 Error processing order

• 10001 The user belongs to a country that AhoraCrypto does not operated in.

To call the API, it is essential to include the x-api-key header.

We can retrieve the payment instructions by calling the following method:

get

Path parameters

idstringrequired

Header parameters

x-api-keystringrequired

API key for authentication

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.ahoracrypto.com/payment/intent/{id}/status' \
  --header 'x-api-key: text'

200

401

404

500

200

{
  "status": 1,
  "orderNumber": "text"
}

Get order status by payment intent ID