Перейти к содержанию

PayIn - P2P - H2H#

На этой странице описаны методы для работы с ордерами на ввод типа P2P по флоу H2H.

Создание ордера#

Создаёт ордер и синхронно выдаёт реквизиты для оплаты клиента.

Запрос#

URL: POST https://<host>/api/v3/merchant/orders/payin/p2p/h2h

Заголовки:

Тело запроса:

Поле Тип Обязательное Описание
methodID integer да Метод ордера
amount float64 да Сумма ордера в фиате, округляется до 2 знаков
clientID string нет Идентификатор клиента
merchantOrderID string нет Идентификатор ордера мерчанта; уникален в рамках мерчанта
trafficType string нет Тип трафика
callbackURL string нет URL для отправки КБ
clientMetadata object нет Данные клиента, см. "Общая информация"

Пример cURL#

curl -X 'POST' \
  'https://<host>/api/v3/merchant/orders/payin/p2p/h2h' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <YOUR-API-KEY>' \
  -d '{
  "methodID": 9,
  "amount": 100.12,
  "clientID": "ID1234",
  "merchantOrderID": "316b6280-d6e2-4627-bacd-fcda062438bc",
  "trafficType": "mixed",
  "callbackURL": "http://example.com/webhook",
  "clientMetadata": {
    "phone": "88005553535",
    "operator": "mts",
    "name": "Ivan Ivanov",
    "email": "ivan@example.com",
    "otp": "123456",
    "documentType": "CI",
    "documentNumber": "12345678",
    "streetAddress": "Av. 18 de Julio 1234",
    "city": "Montevideo",
    "zipCode": "11200"
  }
}'

Ответ#

HTTP Status Code: 200

Тело ответа - модель ордера OrderOut (см. "Общая информация") с блоком реквизитов платежа paymentDetails - куда клиенту нужно выполнить платёж:

{
  "id": "9c37e448-84b5-4639-9ffa-29558f8f2567",
  "createdAt": "2026-08-31T16:08:06.310479Z",
  "updatedAt": "2026-08-31T16:08:06.825346Z",
  "type": "PayIn",
  "direction": "PayIn",
  "status": "payment_pending",
  "merchantOrderID": "316b6280-d6e2-4627-bacd-fcda062438bc",
  "clientID": "ID1234",
  "methodID": 9,
  "paymentDetails": {
    "requisiteTypeCode": "card",
    "recipientName": "Ivan Ivanov",
    "recipientNumber": "1111 2222 3333 4444",
    "recipientBank": "SBER"
  },
  "currencyCode": "AZN",
  "amount": 100.12,
  "merchantCommission": 0.5,
  "amountUSDT": 56.179801,
  "merchantCommissionUSDT": 0.280899,
  "exchangeRate": 1.78,
  "trafficType": "mixed"
}

Возможные бизнес-отказы (400/409) - см. таблицу errorCode на странице "Авторизация запросов". Если ни один провайдер метода не выдал реквизиты, запрос завершается отказом с errorCode = no_payment_details_available.

Условия отправки коллбэков#

Вебхук отправляется при переходе ордера в один из триггерных статусов. Полный список - на странице "Коллбэки".