Нигерия
Банковские переводы и оплата через кошелёк OPay в NGN
Перед тем как начать
Авторизация
Как подписывать запросы API-токеном.
Создание платежа
Базовый запрос на создание заказа, который расширяет эта страница.
Этот способ оплаты доступен не всем мерчантам. Уточните доступность у вашего менеджера.
Обзор
| Валюта | Код страны | Способы оплаты |
|---|---|---|
NGN | NG | Банковский перевод с документом · Банковский перевод на одноразовый счёт / OPay · Банковский перевод с BVN |
В Нигерии доступны три варианта интеграции. Они используют разных провайдеров и требуют разные данные плательщика; какой из них включён для вашего аккаунта, определяется настройками терминала.
Не уверены, какой вариант у вас? Уточните у менеджера.
Чем отличается от обычного заказа
Заказ создаётся через стандартный эндпоинт POST /v1/orders. Базовые поля (amount, currency, successUrl, failUrl, callbackUrl и т. д.) такие же, как у обычного заказа; дополнительно к ним передаётся объект customer с данными плательщика.
| Поле | Тип | Описание |
|---|---|---|
customer | object | Данные плательщика. Набор обязательных полей приведён ниже |
Плательщик перенаправляется на paymentLink и завершает перевод на странице провайдера. Требуется документ, удостоверяющий личность плательщика.
Для этого способа оплаты поле externalUserId обязательно.
Поля объекта customer
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
country | string | ✅ Да | Код страны, всегда NG |
phone | string | ✅ Да | Номер телефона плательщика |
document | string | ✅ Да | Номер документа плательщика |
documentType | string | ✅ Да | Тип документа, например ID |
email | string | ✅ Да | Email плательщика |
firstName | string | ✅ Да | Имя |
lastName | string | ✅ Да | Фамилия |
Пример запроса
{
"purpose": "Payment for order #1234",
"amount": "1000.5",
"currency": "NGN",
"externalId": "external_id",
"externalUserId": "external_user_id",
"successUrl": "https://example.com/success",
"failUrl": "https://example.com/fail",
"callbackUrl": "https://example.com/webhooks/payments",
"isFeeOnUser": false,
"customer": {
"firstName": "John",
"lastName": "Doe",
"country": "NG",
"phone": "2348012345678",
"email": "john.doe@example.com",
"document": "A123456789",
"documentType": "ID"
}
}paymentLink открывает страницу с реквизитами временного банковского счёта (название банка, номер счёта, имя получателя). Плательщик самостоятельно делает перевод по этим реквизитам из своего банковского приложения или кошелька OPay.
Реквизиты одноразовые и действуют только на точную сумму заказа. Предупредите плательщика, что перевести нужно ровно указанную сумму одним платежом. Иначе обработка может сильно затянуться, а средства могут быть потеряны.
Поля объекта customer
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
country | string | ✅ Да | Код страны, всегда NG |
email | string | ✅ Да | Email плательщика |
phone | string | Для OPay | Номер телефона плательщика, обязателен для OPay |
firstName | string | ❌ Нет | Имя |
lastName | string | ❌ Нет | Фамилия |
Пример запроса
{
"purpose": "Payment for order #1234",
"amount": "10000",
"currency": "NGN",
"externalId": "external_id",
"externalUserId": "external_user_id",
"successUrl": "https://example.com/success",
"failUrl": "https://example.com/fail",
"callbackUrl": "https://example.com/webhooks/payments",
"isFeeOnUser": false,
"customer": {
"firstName": "John",
"lastName": "Doe",
"country": "NG",
"phone": "2349061239999",
"email": "john.doe@example.com"
}
}Плательщик перенаправляется на paymentLink и завершает перевод на странице провайдера. Требуются BVN (Bank Verification Number) и код банка плательщика.
Поля объекта customer
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
country | string | ✅ Да | Код страны, всегда NG |
firstName | string | ✅ Да | Имя |
lastName | string | ✅ Да | Фамилия |
phone | string | ✅ Да | Номер телефона плательщика |
email | string | ✅ Да | Email плательщика |
bankAccount | string | ✅ Да | BVN плательщика (Bank Verification Number), 11 цифр |
bankCode | string | ✅ Да | Код банка плательщика |
Пример запроса
{
"purpose": "Payment for order #1234",
"amount": "1000.5",
"currency": "NGN",
"externalId": "external_id",
"externalUserId": "external_user_id",
"successUrl": "https://example.com/success",
"failUrl": "https://example.com/fail",
"callbackUrl": "https://example.com/webhooks/payments",
"isFeeOnUser": false,
"customer": {
"firstName": "John",
"lastName": "Doe",
"country": "NG",
"phone": "2348012345678",
"email": "john.doe@example.com",
"bankAccount": "22123456789",
"bankCode": "058"
}
}Ответ
В ответе возвращается стандартный объект заказа. Заказ создаётся со статусом CREATED; перенаправьте плательщика на paymentLink, чтобы он завершил оплату.