Create apm invoice
POST/merchant-api/v1/invoices/create-apm
This method is creating apm invoice
Request
- application/json
Body
required
The description for the Post Body.
Amount of money for invoice
Id of the gate used for transaction
Comment for invoice
Possible values: [USD, EGP, RUB, KZT, EUR, UAH, MXN, INR, TRY, UZS, AZN, MDL, VND, KRW, AED, IDR, PKR, PEN, CLP, MAD, BYN, COP, NGN, ZAR, SAR, XOF, CAD, AUD, GBP, PLN, NZD, NOK, DKK, SEK, HUF, PHP, TJS, RSD]
Currency of the invoice
Client information must be unique
The URL to which the payer will be redirected after successful payment of the invoice
The URL to which the payer will be redirected after an unsuccessful invoice payment
URL address to which the transaction status notification will be sent
Payer's ip address
User's account that is associated with the wallet(E-mail for example)
Payers's email
Payers's first name
Payers's last name
Your customer’s billing country code in ISO 3166-1 alpha-3 format
Your customer's country name
Customer city of residence.Needed for some gates
Customer state of residence.Needed for some gates
Payers's postal zip
Customer address. Needed for some gates
When making a payment in South Africa, you must additionally pass the user's identification document number in the doc_number parameter. This can be a passport number (1 letter and 8 digits) or a user identification number (13 digits). When performing a purchase in MXN currency you need to add doc_number parameter containing the customer's document number: CURP (contains 18 digits) for Mexico. In COP currency you need to add doc_number parameter, only digits without spaces and punctuation. Set this parameter to the number of the Citizenship Card (CC—Cédula de Ciudadanía) or to the Colombia Unique Taxpayer Number (NIT—Número de Identificación Tributaria)
Type of the document, needed for some COP currency gates possible values: CC, NIT
Payers's phone number with country code, '+' - is optional
Phone service provider FREEMONEY, EXPRESSO, ORANGE, MTN - for XOF currency, ETISALAT, ORANGE, VODAFONE, WEPAY - for the currency EGP
Your customer’s date of birth (must be 18+ y.o.).In ISO 8601 format
Payers's phone country code
Cvv of the credit card
Expiration month of the credit card
Expiration year of the credit card
Card number of the credit card
Cardholder of the credit card
Possible values: [ru, en, ua, es, it, de, pt, bg, pl, fr]
Language of the form
Possibility to create a payment token
Url of your project needed for some gates
Responses
- 201
The apm invoice has been successfully created.
- application/json
- Schema
- Example (from schema)
Schema
Unique id of the invoice
Amount of money to pay for the invoice
Possible values: [Created, Pending, Failed, Succeed, Refund]
Current status of the invoice
Current remark of the invoice
Currency of the invoice
Url for invoice payment
the information about the client
the description of the invoice
Time stamp of the invoice creation
{
"transaction_uid": "6f15174c-241a-41d9-91be-001454f9c13b",
"amount": "2500",
"status": "Created",
"remark": "",
"currency_id": "RUB",
"invoice_url": "http://smart-gates.ru/123232112321",
"external_id": "code123",
"comment": "My first invoice",
"created_at": "2022-09-15T07:26:13.893Z"
}