Гана
Выплаты на мобильные кошельки и банковские счета в GHS
Перед тем как начать
Авторизация
Как подписывать запросы API-токеном.
Обзор выплат
Общий формат запроса, поля ответа и статусы.
Это направление выплат доступно не всем мерчантам. Уточните доступность у вашего менеджера и убедитесь, что на вашем балансе мерчанта достаточно средств, прежде чем создавать выплату.
Обзор
| Валюта | Код страны | Куда | paymentType |
|---|---|---|---|
GHS | GH | Мобильные деньги: MTN, Airtel, Vodafone | SIM |
GHS | GH | Банковский перевод | BANK_ACCOUNT |
Каждый оператор или банковский метод — отдельный сервис выплат. Список включённых для вас сервисов возвращает GET /v1/payouts/services; передайте serviceId нужного, без него используется сервис по умолчанию.
Получатель должен быть клиентом оператора выбранного сервиса: выплата через сервис MTN не дойдёт на кошелёк Orange.
Набор обязательных полей зависит от включённого для вас сервиса. Если нужного поля нет, телефон не соответствует стране или тип выплаты не подходит сервису, выплата отклоняется с 400 до создания, баланс не списывается. Передавайте userEmail, когда он у вас есть.
Поля account
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
name | string | ✅ Да | Имя получателя |
requisites | string | ✅ Да | Реквизиты получателя: номер карты, номер телефона, PIX-ключ и т. д. в зависимости от paymentType |
userId | string | ✅ Да | ID пользователя в вашей системе |
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
requisites | string | ✅ Да | Телефон кошелька получателя в международном формате, только цифры, без +: 233241234567 |
userEmail | string | ⚠️ Зависит от сервиса | Email получателя |
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": 500,
"currency": "GHS",
"paymentType": "SIM",
"serviceId": 123,
"externalId": "payout-123",
"account": {
"name": "John Doe",
"requisites": "233241234567",
"userId": "user_12345",
"userEmail": "john.doe@example.com"
},
"note": "Payout for order #1234"
}'Получите код банка
Сервисам банковских переводов нужен банк получателя. Запросите список банков сервиса и передайте выбранный 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 | ✅ Да | Номер банковского счёта получателя |
bankName | string | ✅ Да | Банк получателя: id из GET /v1/payouts/banks?serviceId=… |
userEmail | string | ✅ Да | Email получателя |
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": 500,
"currency": "GHS",
"paymentType": "BANK_ACCOUNT",
"serviceId": 123,
"externalId": "payout-123",
"account": {
"name": "John Doe",
"requisites": "2030050920719",
"userId": "user_12345",
"bankName": "000013",
"userEmail": "john.doe@example.com"
},
"note": "Payout for order #1234"
}'Передавайте суммы в GHS целыми числами: некоторые сервисы не принимают дробные суммы.
Ответ
В ответе возвращается стандартный объект выплаты со статусом CREATED. Сохраните id, чтобы отслеживать выплату.
Поля объекта выплаты
Финальный статус обычно приходит в течение нескольких минут.