Тип AV
Как провести платёж через терминал типа AV.
Перед началом работы
Как авторизовать запросы
Как создавать обычные заказы
Эта интеграция доступна не всем мерчантам. Уточните доступность у вашего менеджера.
Чем отличается от обычного заказа?
Для этого способа оплаты вы добавляете дополнительные поля в customer. Остальные поля (amount, currency, successUrl, failUrl и т. д.) остаются такими же, как при создании обычного заказа.
Поле customer.country и хотя бы одно из customer.phone или
customer.email обязательны для этого способа оплаты.
Дополнительные поля для обычного заказа
| Поле | Тип | Описание |
|---|---|---|
customer | object | Данные покупателя (email, телефон, адрес и т. д.) |
ЮАР (Bank Transfer)
paymentLink из ответа перенаправляет покупателя на страницу провайдера, где он завершает оплату.
Поля объекта customer
| Поле | Тип | Описание |
|---|---|---|
country | string | Код страны для платежа (ZA), обязательное |
phone | string | Телефон покупателя, формат 27XXXXXXXXX |
email | string | Email покупателя, обязательное |
firstName | string | Имя, обязательное |
lastName | string | Фамилия, обязательное |
Пример запроса
{
"purpose": "Payment for order #1234",
"amount": "1000.5",
"externalId": "external_id",
"externalUserId": "external_user_id",
"successUrl": "https://example.com",
"failUrl": "https://example.com",
"callbackUrl": "https://example.com",
"currency": "ZAR",
"isFeeOnUser": false,
"customer": {
"lastName": "Doe",
"firstName": "John",
"country": "ZA",
"phone": "27000000000",
"email": "john.doe@example.com"
}
}Пример ответа
{
"id": "a1b2c3d4-e5f6-7g8h-i9j0-k1l2m3n4o5p6",
"status": "CREATED",
"statusMessage": "Ok",
"purpose": "Payment for order #1234",
"amount": "1000.5",
"currency": "ZAR",
"paymentType": null,
"shopId": "a1b2c3d4-e5f6-7g8h-i9j0-k1l2m3n4o5p6",
"terminalId": "a1b2c3d4-e5f6-7g8h-i9j0-k1l2m3n4o5p6",
"fingerprint": null,
"ipAddress": null,
"gatewayTransactionId": null,
"merchantId": "a1b2c3d4-e5f6-7g8h-i9j0-k1l2m3n4o5p6",
"externalId": "external_id",
"externalUserId": "external_user_id",
"paymentLink": "https://example.com/payment",
"successUrl": "https://example.com",
"failUrl": "https://example.com",
"metadata": null,
"callbackUrl": "https://example.com",
"payedAt": null,
"updatedAt": "2023-03-21T12:34:56Z",
"createdAt": "2023-03-21T12:34:56Z"
}Нигерия (Bank Transfer / OPay)
paymentLink из ответа открывает платёжную страницу с реквизитами временного банковского счёта (банк, номер счёта, имя получателя). Покупатель делает перевод по этим реквизитам из своего банковского приложения или кошелька.
Реквизиты одноразовые и действуют только на точную сумму заказа. Предупредите покупателя, что перевести нужно ровно указанную сумму одним платежом — иначе обработка может сильно затянуться, а средства могут быть потеряны.
Поля объекта customer
| Поле | Тип | Описание |
|---|---|---|
country | string | Код страны для платежа (NG), обязательное |
phone | string | Телефон покупателя, обязателен для OPay |
email | string | Email покупателя, обязательное |
firstName | string | Имя |
lastName | string | Фамилия |
Пример запроса
{
"purpose": "Payment for order #1234",
"amount": "10000",
"externalId": "external_id",
"externalUserId": "external_user_id",
"successUrl": "https://example.com",
"failUrl": "https://example.com",
"callbackUrl": "https://example.com",
"currency": "NGN",
"isFeeOnUser": false,
"customer": {
"lastName": "Doe",
"firstName": "John",
"country": "NG",
"phone": "2349061239999",
"email": "john.doe@example.com"
}
}Пример ответа
{
"id": "a1b2c3d4-e5f6-7g8h-i9j0-k1l2m3n4o5p6",
"status": "CREATED",
"statusMessage": "Ok",
"purpose": "Payment for order #1234",
"amount": "10000",
"currency": "NGN",
"paymentType": null,
"shopId": "a1b2c3d4-e5f6-7g8h-i9j0-k1l2m3n4o5p6",
"terminalId": "a1b2c3d4-e5f6-7g8h-i9j0-k1l2m3n4o5p6",
"fingerprint": null,
"ipAddress": null,
"gatewayTransactionId": null,
"merchantId": "a1b2c3d4-e5f6-7g8h-i9j0-k1l2m3n4o5p6",
"externalId": "external_id",
"externalUserId": "external_user_id",
"paymentLink": "https://example.com/payment",
"successUrl": "https://example.com",
"failUrl": "https://example.com",
"metadata": null,
"callbackUrl": "https://example.com",
"payedAt": null,
"updatedAt": "2023-03-21T12:34:56Z",
"createdAt": "2023-03-21T12:34:56Z"
}