Западная Африка
Выплаты в XOF на мобильные деньги (mobile money) в Кот-д’Ивуар, Сенегал и другие страны
Перед тем как начать
Авторизация
Как подписывать запросы API-токеном.
Обзор выплат
Общий формат запроса, поля ответа и статусы.
Это направление выплат доступно не всем мерчантам. Уточните доступность у вашего менеджера и убедитесь, что на вашем балансе мерчанта достаточно средств, прежде чем создавать выплату.
Обзор
| Валюта | Направление | Тип платежа |
|---|---|---|
XOF | Кошельки мобильных денег (mobile money): MTN, Orange, Wave, Moov, Free Money | SIM |
Основные направления — Кот-д’Ивуар и Сенегал. Каждая пара «страна + оператор» — это отдельный сервис выплат; выбирайте его через serviceId.
Другие валюты
CDF, GHS, KES, NGN, ZAR, UGX, TZS, ZMW и BDT доступны по согласованию с вашим менеджером.
Требования к суммам: суммы в XOF должны быть целыми и кратными 5; суммы в TZS, KES, GHS и UGX должны быть целыми.
Выбор направления
GET /v1/payouts/servicesПри создании выплаты передавайте serviceId нужного оператора. Если он не указан, используется сервис по умолчанию. Убедитесь, что это именно то направление, на которое вы хотите выплатить.
Номер телефона получателя должен принадлежать оператору выбранного сервиса. Кошелёк Wave (Сенегал) нельзя пополнить через сервис Orange (Кот-д’Ивуар).
Поля account
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
name | string | ✅ Да | Имя получателя |
requisites | string | ✅ Да | Реквизиты получателя: номер карты, номер телефона, PIX-ключ и т. д. в зависимости от paymentType |
userId | string | ✅ Да | ID пользователя в вашей системе |
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
userEmail | string | ❌ Нет | Email получателя. Рекомендуется передавать всегда; для части сервисов обязателен |
userIp | string | ❌ Нет | IP-адрес получателя |
requisites — номер телефона кошелька в международном формате, только цифры, без +: Кот-д’Ивуар 2250700000001, Сенегал 221700000001.
Пример запроса
curl -X POST "https://api.riopay.online/v1/payouts" \
-H "Content-Type: application/json" \
-H "X-Api-Token: YOUR_API_TOKEN" \
-d '{
"amount": 10000,
"currency": "XOF",
"paymentType": "SIM",
"serviceId": 123,
"externalId": "payout-123",
"account": {
"name": "John Doe",
"requisites": "2250700000001",
"userId": "user_12345",
"userEmail": "john.doe@example.com"
},
"note": "Выплата по заказу №1234"
}'Ответ
В ответе возвращается стандартный объект выплаты со статусом CREATED. Сохраните id, чтобы отслеживать выплату.
Поля объекта выплаты
Финальный статус обычно приходит в течение нескольких минут.