Skip to content

APM - AZN with Peer to Peer (Gateway1)#

Alternative payment methods: deposit with Peer to Peer AZN transfer

Brief#

In order to create a Fixed Rate Invoice in the payment processing system, you need to make a POST request to the v2/invoices API endpoint.

POST https://api.xgateway.tech/api/v2/invoices
AZN Peer to Peer deposits 
{
    "amount": 150,
    "baseCurrency": "AZN",
    "displayCurrencies": "AZN",
    "customerId": "test-customer-id",
    "orderId": "test-order-id"
}

See the Alternative Payment Methods using Checkout page for the full OpenAPI specification.

The default lifetime of an invoice is 15 minutes.

Our local partners for Alternative Payment Methods may block customers using VPNs. It is generally recommended to warn customers that a payment method cannot be accessed through a VPN.

Details#

Validating limits#

The invoice creation API validates the amount value. The minimum and maximum amount values may differ based on the payment provider used for each specific invoice.
AZN Peer to Peer (Gateway1) uses these:

Currency Min value Max value Increment step
AZN 100.00 2 500.00 0.01

Contact the support team if you want to confirm the limits.

Required payload#

Parameter Mandatory Description
amount true Requested amount. String or Number, in d+(.d+)? format. Limits applied
customerId true Customer id in the merchant system
baseCurrency true String representation of the requested currency. AZN in this case
orderId false Invoice id in the merchant system. If provided, used as an idempotency key
displayCurrencies false Currency code or list of currencies to display on the checkout page

Ensure that no additional parameters, except those specified above, are passed into the invoice creation request.

Payload examples#

The system will skip all XGateway intermediate pages and redirect the customer directly to the payment method only if all required data is provided.

AZN Peer to Peer deposits 
{
    "amount": 150,
    "baseCurrency": "AZN",
    "displayCurrencies": "AZN",
    "customerId": "test-customer-id",
    "orderId": "test-order-id"
}

If you get a bad request response without exact information about the erroneous field, please check the syntax of the request.

API Response#

After a successful call, you will receive a 201 - Created response with a link to a Checkout page configured according to your request. 

{
  "data": "https://checkout.xgateway.tech/ff36a7a5-08fd-418a-a150-f6f2d36676a8",
  "success": true
}

The Checkout page will prompt the customer for any data missing from the initial request that is required to create an invoice.

Once all required data is provided, the Checkout page will redirect the customer to the local payment system.