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

PayIn - QuasiEcom - H2H#

На этой странице описаны методы для работы с ордерами на ввод типа QuasiEcom по флоу H2H: оплата картой с подтверждением кодом 3-D Secure/SMS.

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

Запрос#

URL: POST https://<host>/api/v3/merchant/orders/payin/quasi-ecom/h2h

Заголовки:

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

Поле Тип Обязательное Описание
methodID integer да Метод перевода
amount float64 да Сумма ордера в фиате, округляется до 2 знаков
cardNumber string да Номер карты (16 цифр)
cvc string да CVC/CVV (3 цифры)
expireMonth string да Месяц срока действия карты, MM
expireYear string да Год срока действия карты, YY
cardholderName string да Имя держателя карты
clientID string нет Идентификатор клиента
merchantOrderID string нет Идентификатор ордера мерчанта; уникален в рамках мерчанта
trafficType string нет Тип трафика
callbackURL string нет URL для отправки КБ
clientMetadata object нет Данные клиента, см. "Общая информация"

Пример cURL#

curl -X 'POST' \
  'https://<host>/api/v3/merchant/orders/payin/quasi-ecom/h2h' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <YOUR-API-KEY>' \
  -d '{
  "methodID": 12,
  "amount": 100.12,
  "cardNumber": "4111111111111111",
  "cvc": "123",
  "expireMonth": "12",
  "expireYear": "29",
  "cardholderName": "IVAN IVANOV",
  "clientID": "ID1234",
  "merchantOrderID": "316b6280-d6e2-4627-bacd-fcda062438bc",
  "trafficType": "mixed",
  "callbackURL": "http://example.com/webhook"
}'

Ответ#

HTTP Status Code: 200

Тело ответа - модель ордера OrderOut (см. "Общая информация"). Тип ордера - QuasiEcom, направление - PayIn. Если требуется подтверждение 3-D Secure/SMS, ордер создаётся со статусом confirm_waiting:

{
  "id": "9c37e448-84b5-4639-9ffa-29558f8f2567",
  "createdAt": "2026-08-31T16:08:06.310479Z",
  "updatedAt": "2026-08-31T16:08:06.825346Z",
  "type": "QuasiEcom",
  "direction": "PayIn",
  "status": "confirm_waiting",
  "merchantOrderID": "316b6280-d6e2-4627-bacd-fcda062438bc",
  "clientID": "ID1234",
  "methodID": 12,
  "currencyCode": "AZN",
  "amount": 100.12,
  "exchangeRate": 1.78,
  "trafficType": "mixed"
}

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

Подтверждение ордера кодом#

Подтверждает ордер в статусе confirm_waiting кодом из 3-D Secure/SMS.

Запрос#

URL: POST https://<host>/api/v3/merchant/orders/{id}/quasi-ecom/confirm

  • {id} - UUID ордера

Заголовки:

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

Поле Тип Обязательное Описание
code string да Код подтверждения

Пример cURL#

curl -X 'POST' \
  'https://<host>/api/v3/merchant/orders/9c37e448-84b5-4639-9ffa-29558f8f2567/quasi-ecom/confirm' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <YOUR-API-KEY>' \
  -d '{
  "code": "123456"
}'

Ответ#

HTTP Status Code: 200

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

Ошибки (400 с errorCode = invalid_request_parameters):

  • Неверный код подтверждения
  • Ордер находится вне статуса confirm_waiting (уже подтверждён или в финальном статусе)

Ордер не найден - 404.

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

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