Документация/Все методы API

Создание P2P-платежа (v1)

POST/selector/v1/sale

Плательщик переводит средства по номеру банковского счета.

1. Покажите данные для перевода

Покажите полученные реквизиты, сумму и срок действия. Клиент должен перевести сумму из ответа в пределах ttl, указанного в минутах.

Примечания

При конвертации ответ также может содержать target_amount и target_currency.

POSThttps://secure-api.404stage.com/selector/v1/saleПрямой запрос к API

Запрос

Правила подписи
ЗаголовкиAccept: application/json · Content-Type: application/json

Укажите свои реквизиты и подпись. Запрос отправляется на адрес выше.

Ответ

Запрос выполнен; проверяйте статус операции в ответе.

application/json
{
  "amount": "100.0000",
  "beneficiary": {
    "account_number": "0123456789",
    "ask_utr": false,
    "bank_member_id": "SOME_MEMBER_ID",
    "bank_name": "SOME BANK",
    "country_code": "RU",
    "country_name": "Russia",
    "country_phone_code": "+7",
    "deeplink": "",
    "deeplink_gpay": "",
    "deeplink_paytmmp": "",
    "deeplink_phonepe": "",
    "name": "SOME NAME",
    "pan": "",
    "phone": "",
    "qr": "",
    "receipt_email": "[email protected]",
    "receiver_account_number": "",
    "receiver_bank_name": "",
    "receiver_branch_id": "",
    "receiver_name": "",
    "reference_code": "RFGTQ6"
  },
  "created_at": "2026-01-20T09:49:51.573644Z",
  "currency": "RUB",
  "expired_at": "2026-01-20 10:49:51.573644+00:00",
  "finish_failure_url": "https://merchant.example/failure",
  "finish_success_url": "https://merchant.example/success",
  "invoice_id": "ab0cee2f-59e0-40f6-afca-dbab4f2a5996",
  "payment_status": "pending",
  "status": "success",
  "ttl": "60"
}
Поля выбранного запроса13
amountstring · обязательное

Сумма платежа в указанной валюте.

currencystring · обязательное

Код валюты платежа.

customerstring · обязательное

Уникальный идентификатор плательщика в системе мерчанта.

descriptionstring

Описание или дополнительные сведения о платеже от мерчанта.

emailstring

Email плательщика.

endpoint_idstring · обязательное

ID платёжного эндпоинта. Также принимается имя product_id.

finish_urlstring

URL возврата плательщика после оплаты.

languagestring

Язык интерфейса для плательщика.

merchant_idstring · обязательное

ID мерчанта, выданный при подключении.

notification_urlstring

URL мерчанта для уведомлений о статусе платежа.

orderstring · обязательное

Идентификатор заказа или платежа в системе мерчанта.

payment_typestring · обязательное

Тип перевода, например card, sbp, account или upi; доступность зависит от эндпоинта.

signaturestring · обязательное

Подпись запроса; рассчитывается по правилам раздела о подписи запросов.

Описание и правила метода

Создаёт P2P-платёж и возвращает реквизиты получателя. В зависимости от endpoint доступны сценарии card, sbp, account и upi. В этой версии payment_type и customer обязательны и не могут быть null; при отсутствии любого из них или значении null API возвращает HTTP 400 с code=COMMON_ERROR. Необязательные поля без значения не включаются в ответ. Для UPI значение QR возвращается в beneficiary.deeplink, если отдельный deeplink отсутствует. Переведите сумму amount из ответа в пределах ttl (в минутах); при конвертации на стороне провайдера в ответе могут быть target_amount и target_currency. Проверяйте итоговый статус через /selector/v1/status.

Передавайте JSON в теле запроса (Content-Type: application/json). Рассчитывайте signature по общим правилам подписи для пути URL этого метода. Подписи в примерах — заполнители: замените реквизиты доступа и пересчитайте подпись перед отправкой.

Все параметры и схемыРасширенный справочник метода