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

PayIn - P2P - PaymentPage#

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

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

Создаёт ордер и возвращает URL платёжной страницы; реквизиты для оплаты клиенту выдаёт страница.

Запрос#

URL: POST https://<host>/api/v3/merchant/orders/payin/p2p/payment-page

Заголовки:

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

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

Пример cURL#

curl -X 'POST' \
  'https://<host>/api/v3/merchant/orders/payin/p2p/payment-page' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <YOUR-API-KEY>' \
  -d '{
  "methodID": 9,
  "amount": 100.12,
  "successRedirectURL": "https://merchant.example.com/success",
  "failRedirectURL": "https://merchant.example.com/fail",
  "clientID": "ID1234",
  "merchantOrderID": "316b6280-d6e2-4627-bacd-fcda062438bc",
  "trafficType": "mixed",
  "callbackURL": "http://example.com/webhook"
}'

Ответ#

HTTP Status Code: 200

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

{
  "id": "9c37e448-84b5-4639-9ffa-29558f8f2567",
  "createdAt": "2026-08-31T16:08:06.310479Z",
  "updatedAt": "2026-08-31T16:08:06.310479Z",
  "type": "PayIn",
  "direction": "PayIn",
  "status": "created",
  "merchantOrderID": "316b6280-d6e2-4627-bacd-fcda062438bc",
  "clientID": "ID1234",
  "methodID": 9,
  "currencyCode": "AZN",
  "amount": 100.12,
  "exchangeRate": 1.78,
  "trafficType": "mixed",
  "paymentPageURL": "https://<host>/pay/9c37e448-84b5-4639-9ffa-29558f8f2567"
}

Ордер создаётся со статусом created; поля amountUSDT, merchantCommission и merchantCommissionUSDT заполняются после расчёта по ордеру (см. "Общая информация").

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

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

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