Нигерия
Выплаты в NGN — банковский перевод, кошельки OPay, PalmPay, Pay Attitude
Перед тем как начать
Авторизация
Как подписывать запросы API-токеном.
Обзор выплат
Общий формат запроса, поля ответа и статусы.
Это направление выплат доступно не всем мерчантам. Уточните доступность у вашего менеджера и убедитесь, что на вашем балансе мерчанта достаточно средств, прежде чем создавать выплату.
Обзор
| Валюта | Код страны | Куда | paymentType |
|---|---|---|---|
NGN | NG | Банковский перевод, кошельки OPay, PalmPay, Pay Attitude | BANK_ACCOUNT |
Каждый оператор или банковский метод — отдельный сервис выплат. Список включённых для вас сервисов возвращает GET /v1/payouts/services; передайте serviceId нужного, без него используется сервис по умолчанию.
Набор обязательных полей зависит от включённого для вас сервиса. Если нужного поля нет, телефон не соответствует стране или тип выплаты не подходит сервису, выплата отклоняется с 400 до создания, баланс не списывается. Передавайте userEmail, когда он у вас есть.
Получите код банка
Сервисам банковских переводов нужен банк получателя. Запросите список банков сервиса и передайте выбранный id в account.bankName:
curl -X GET "https://api.1capital.capital/v1/payouts/banks?serviceId=123" \
-H "X-Api-Token: YOUR_API_TOKEN"{
"data": [
{ "id": "000013", "name": "Example Bank" },
{ "id": "000014", "name": "Another Bank" }
]
}Поля account
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
name | string | ✅ Да | Имя получателя |
requisites | string | ✅ Да | Реквизиты получателя: номер карты, номер телефона, PIX-ключ и т. д. в зависимости от paymentType |
userId | string | ✅ Да | ID пользователя в вашей системе |
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
requisites | string | ✅ Да | Номер банковского счёта или кошелька получателя (у кошельков OPay, PalmPay и Pay Attitude — номер счёта) |
bankName | string | ⚠️ Зависит от сервиса | Банк получателя: id из GET /v1/payouts/banks?serviceId=… |
userEmail | string | ⚠️ Зависит от сервиса | Email получателя |
userPhone | string | ⚠️ Зависит от сервиса | Телефон получателя, цифры с кодом страны: 2348012345678 |
userIp | string | ❌ Нет | IP-адрес получателя |
Пример запроса
curl -X POST "https://api.1capital.capital/v1/payouts" \
-H "Content-Type: application/json" \
-H "X-Api-Token: YOUR_API_TOKEN" \
-d '{
"amount": 50000,
"currency": "NGN",
"paymentType": "BANK_ACCOUNT",
"serviceId": 123,
"externalId": "payout-123",
"account": {
"name": "John Doe",
"requisites": "0123456789",
"userId": "user_12345",
"bankName": "000013",
"userEmail": "john.doe@example.com",
"userPhone": "2348012345678"
},
"note": "Payout for order #1234"
}'Ответ
В ответе возвращается стандартный объект выплаты со статусом CREATED. Сохраните id, чтобы отслеживать выплату.
Поля объекта выплаты
Финальный статус обычно приходит в течение нескольких минут.