PayIn | МобКом (трансгран)

Плательщик пополняет счёт абонента мобильного оператора другой страны. Сумма заказа — в рублях, к оплате — requisites.amount_local.

Чтобы получить реквизиты по методу МобКом (трансгран), отправьте запрос (на примере curl):

curl -X POST https://api.bopay.io/v1/payments \
  -H "Content-Type: application/json" \
  -H "X-Identity: <API-key>" \
  -H "X-Signature: <Signature>" \
  -d '{
  "ext_id": "order_12345",
  "amount": 1000,
  "currency": "RUB",
  "method": "CROSS_BORDER_SIM",
  "country": "TJ",
  "bank": "tcell",
  "notify_url": "https://merchant.example/webhook"
}'

POST /v1/payments — заголовки и подпись: Авторизация.

Параметры

Поле	Тип	Обязательно	Описание
ext_id	string	да	ID заказа у вас, уникальный
amount	number	да	Сумма в рублях
currency	string	да	RUB. Терминал должен работать в рублях
method	string	да	CROSS_BORDER_SIM
country	string	нет	Страна реквизита (ISO-2), например TJ. Без неё — любая доступная страна
bank	string	нет	Код оператора из справочника, например tcell
client_id	string	нет	ID плательщика у вас
notify_url	string	нет	Адрес для вебхуков
notification_token	string	нет	Возвращается в заголовке X-Notification-Token вебхука

В ответ придут реквизиты:

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "ext_id": "order_12345",
  "amount": 1000,
  "currency": "RUB",
  "status": "PENDING",
  "method": "CROSS_BORDER_SIM",
  "requisites": {
    "type": "sim",
    "value": "+992900123456",
    "bank": "tcell",
    "bank_name": "Tcell",
    "country": "TJ",
    "currency": "TJS",
    "amount_local": 118.5
  },
  "payment_url": "https://pay.bopay.io/invoice?id=550e8400-e29b-41d4-a716-446655440000",
  "valid_until": "2026-01-30T12:30:00Z",
  "created_at": "2026-01-30T12:15:00Z"
}

Поля ответа

Поле	Описание
id	ID платежа
requisites.value	Куда платить: номер телефона абонента
requisites.bank	Банк
requisites.amount_local	Сумма к оплате в валюте requisites.currency
payment_url	Платёжная страница
valid_until	Срок оплаты

Покажите плательщику requisites или перенаправьте его на payment_url. Плательщик переводит requisites.amount_local в валюте requisites.currency.

Остальные поля и ошибки — в Создание платежа. Статус — вебхук или GET /v1/payments/{id}.