ДР Конго
Оплата мобильными деньгами в CDF
Перед тем как начать
Авторизация
Как подписывать запросы API-токеном.
Создание платежа
Базовый запрос на создание заказа, который расширяет эта страница.
Этот способ оплаты доступен не всем мерчантам. Уточните доступность у вашего менеджера.
Обзор
| Валюта | Код страны | Способы оплаты |
|---|---|---|
CDF / USD | CD | Мобильные деньги: Africel, Airtel, Orange Money, Vodacom, Vodacom (M-Pesa) · карта (USD) |
Доступны два сценария. Какой сценарий и какой оператор включены для вашего аккаунта, определяется настройками терминала.
Не уверены, какой вариант у вас? Уточните у менеджера.
Чем отличается от обычного заказа
Заказ создаётся через стандартный эндпоинт POST /v1/orders. Базовые поля (amount, currency, successUrl, failUrl, callbackUrl и т. д.) такие же, как у обычного заказа; дополнительно к ним передаётся объект customer с данными плательщика.
| Поле | Тип | Описание |
|---|---|---|
customer | object | Данные плательщика. Набор обязательных полей приведён ниже |
Для этого способа оплаты поле externalUserId обязательно.
Операторы: Africel, Airtel, Orange Money, Vodacom, Vodacom (M-Pesa).
Отправьте плательщика на paymentLink: запрос на оплату уходит оператору при открытии ссылки, и плательщик подтверждает его на телефоне (push-уведомление или USSD-запрос). Страница ждёт результата и показывает его; финальный статус также приходит на ваш callbackUrl.
Поля объекта customer
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
phone | string | ✅ Да | Номер телефона плательщика в международном формате 243812345678. В формат оператора (с ведущим 0 или без) он приводится автоматически |
firstName | string | ⚠️ Зависит от оператора | Имя |
lastName | string | ⚠️ Зависит от оператора | Фамилия |
email | string | ⚠️ Зависит от оператора | Email плательщика |
country | string | ❌ Нет | Код страны CD. Необязателен: страна определяется методом |
Обязательный набор зависит от оператора, включённого на терминале. Если нужного поля нет или телефон не соответствует формату страны, заказ отклоняется с 400 и списком полей. Передавайте firstName, lastName, email и phone, когда они у вас есть.
Пример запроса
{
"purpose": "Payment for order #1234",
"amount": "1000",
"currency": "CDF",
"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",
"phone": "243812345678",
"email": "john.doe@example.com"
}
}Карта: Mastercard, USD.
Плательщик перенаправляется на paymentLink — карточную страницу провайдера — и оплачивает там.
Поля объекта customer
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
phone | string | ⚠️ phone или email | Номер телефона плательщика в международном формате 243812345678. В формат оператора (с ведущим 0 или без) он приводится автоматически |
firstName | string | ❌ Нет | Имя |
lastName | string | ❌ Нет | Фамилия |
email | string | ⚠️ phone или email | Email плательщика |
country | string | ❌ Нет | Код страны CD. Необязателен: страна определяется методом |
Обязательный набор зависит от оператора, включённого на терминале. Если нужного поля нет или телефон не соответствует формату страны, заказ отклоняется с 400 и списком полей. Передавайте firstName, lastName, email и phone, когда они у вас есть.
Пример запроса
{
"purpose": "Payment for order #1234",
"amount": "10",
"currency": "USD",
"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",
"phone": "243812345678",
"email": "john.doe@example.com"
}
}Часть методов в ДР Конго работает в USD вместо CDF; валюта заказа должна совпадать с методом, включённым на терминале.
Ответ
В ответе возвращается стандартный объект заказа. Заказ создаётся со статусом CREATED; перенаправьте плательщика на paymentLink, чтобы он завершил оплату.