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

PayIn - Ecom - PaymentPage#

На этой странице описаны методы для работы с ордерами на ввод типа Ecom по флоу PaymentPage: классическая оплата картой через интернет-эквайринг. Клиент вводит карту на платёжной странице, 3-D Secure проходит на стороне шлюза, финальный результат мерчант получает коллбэком или запросом ордера.

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

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

Запрос#

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

Заголовки:

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

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

Пример cURL#

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

Ответ#

HTTP Status Code: 200

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

{
  "id": "0f0e6d34-1b2a-4c5d-8e9f-0a1b2c3d4e5f",
  "createdAt": "2026-08-31T16:08:06.310479Z",
  "updatedAt": "2026-08-31T16:08:06.310479Z",
  "type": "Ecom",
  "direction": "PayIn",
  "status": "created",
  "merchantOrderID": "316b6280-d6e2-4627-bacd-fcda062438bc",
  "clientID": "ID1234",
  "methodID": 205,
  "currencyCode": "TRY",
  "amount": 1500.50,
  "trafficType": "ftd",
  "paymentPageURL": "https://<host>/payin/orders/0f0e6d34-1b2a-4c5d-8e9f-0a1b2c3d4e5f?token=<TOKEN>&lang=ru"
}

Ордер создаётся со статусом created; срок жизни ордера ограничен TTL метода.

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

Работа платёжной страницы#

Клиент открывает paymentPageURL и вводит данные карты на платёжной странице сервиса. Если шлюз требует подтверждения, клиент проходит 3-D Secure на стороне шлюза. По финальному статусу клиент перенаправляется на successRedirectURL или failRedirectURL мерчанта. Статус ордера мерчант получает коллбэком или запросом ордера.

Финализация#

Терминальные статусы ордера - succeeded, failed_by_terminal, expired - описаны в статусной модели. По любому из них отправляется коллбэк, а клиент возвращается на successRedirectURL или failRedirectURL мерчанта.

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

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