Карточные методы
Тип DL
Как провести платёж через терминал типа DL.
Перед началом работы
Как авторизовать запросы
Как создавать обычные заказы
Эта интеграция доступна не всем мерчантам. Уточните доступность у вашего менеджера.
Чем отличается от обычного заказа?
Для этого способа оплаты вы добавляете дополнительные поля в customer, а также externalUserId. Остальные поля (amount, currency, successUrl, failUrl и т. д.) остаются такими же, как при создании обычного заказа.
Для этого способа оплаты поле externalUserId является обязательным.
Дополнительные поля для обычного заказа
| Поле | Тип | Описание |
|---|---|---|
customer | object | Данные покупателя (email, телефон, адрес и т. д.) |
Нигерия
Поля объекта customer
| Поле | Тип | Описание |
|---|---|---|
country | string | Код страны для платежа |
phone | string | Телефон покупателя |
document | string | Номер документа покупателя |
documentType | string | Тип документа покупателя |
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": "NGN",
"isFeeOnUser": false,
"customer": {
"lastName": "Doe",
"firstName": "John",
"country": "NG",
"phone": "254700000001",
"email": "john.doe@example.com",
"document": "A123456789",
"documentType": "ID"
}
}Пример ответа
{
"id": "a1b2c3d4-e5f6-7g8h-i9j0-k1l2m3n4o5p6",
"status": "CREATED",
"statusMessage": "Ok",
"purpose": "Payment for order #1234",
"amount": "1000.5",
"currency": "ARS",
"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"
}Кения (Мобильные деньги Mpeso)
Поля объекта customer
| Поле | Тип | Описание |
|---|---|---|
country | string | Код страны для платежа |
email | string | Email покупателя |
firstName | string | Имя |
lastName | string | Фамилия |
Пример запроса
{
"purpose": "Payment for order #1234",
"amount": "100",
"externalId": "external_id",
"externalUserId": "external_user_id",
"successUrl": "https://example.com",
"failUrl": "https://example.com",
"callbackUrl": "https://example.com",
"currency": "KES",
"isFeeOnUser": false,
"customer": {
"lastName": "Doe",
"firstName": "John",
"country": "KE",
"email": "john.doe@example.com"
}
}Пример ответа
{
"id": "a1b2c3d4-e5f6-7g8h-i9j0-k1l2m3n4o5p6",
"status": "CREATED",
"statusMessage": "Ok",
"purpose": "Payment for order #1234",
"amount": "100",
"currency": "KES",
"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"
}