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

PayIn - QuasiEcom - H2H#

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

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

Запрос#

URL: POST https://<host>/api/v1/payin/quasi-ecom/h2h

Заголовки:

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

Поле Тип Обязательное Описание
methodID integer да Метод перевода. Будет сообщен при интеграции
amount float64 да Сумма платежа в валюте, заданной методом
trafficType string нет Тип трафика. Возможные значения: "ftd" (первичный), "td" (вторичный, доверенный), "mixed" (смешанный). Если значение не указано, используется "mixed"
clientID string нет* ID или имя клиента мерчанта
merchantOrderID string нет ID ордера в системе мерчанта. Должен быть уникальным в рамках одного аккаунта мерчанта
requisites.number string да Номер банковской карты клиента
requisites.mediatorName string да Имя держателя карты, передаваемое в платёжной системе
requisites.lifetimeMonth string да Месяц истечения срока действия карты в формате MM
requisites.lifetimeYear string да Год истечения срока действия карты в формате YY
requisites.cvc string да CVC/CVV код карты
metadata.webHook string нет URL-адрес, по которому будут направлены callback-запросы при изменениях в одрере

* - может являться обязательмым для отдельных интеграций

Пример cURL#

curl -X 'POST' \
  'https://<host>/api/v1/payin/quasi-ecom/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",
  "requisites": {
    "cvc": "123",
    "lifetimeMonth": "10",
    "lifetimeYear": "30",
    "mediatorName": "Ivan Ivanov",
    "number": "1111 2222 3333 4444"
  },
  "metadata": {
    "webHook": "https://example.com/webhook",
    "successRedirectURL": "https://example.com/success",
    "failRedirectURL": "https://example.com/fail"
  }
}'

Ответ#

См. раздел "Структура ответа API методов"

Успешный ответ#

HTTP Status Code: 200

Тело ответа:

{
  "data": {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "status": "created",
    "merchantOrderID": "string",
  },
  "result": {
    "codeError": "none",
    "message": null,
    "status": "success",
    "x-request-id": "4d925d05e23f81170a7d899a482d2391"
  }
}

Описание полей структуры data:

Поле Тип Обязательное Описание
id string да Уникальный ID ордера в системе MoneyMania
status string да Статус ордера. См. статусную модель
merchantOrderID string нет ID ордера в системе мерчанта

Отправка кода подтверждения#

Запрос#

URL: POST https://<host>/api/v1/orders/{id}/ecom-confirm/h2h

  • {id} - ID ордера в системе MoneyMania

Заголовки:

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

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

* - может являться обязательмым для отдельных интеграций

Пример cURL#

curl -X 'POST' \
  'https://<host>/api/v1/orders/3fa85f64-5717-4562-b3fc-2c963f66afa6/ecom-confirm/h2h' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <YOUR-API-KEY>' \
  -d '{
  "code": "123456"
}'

Ответ#

См. раздел "Структура ответа API методов"

Успешный ответ#

HTTP Status Code: 200

Тело ответа:

{
  "data": {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "status": "created",
    "timer": 100,
    "merchantOrderID": "someID",
    "currency": "RUB",
    "amount": 10.2
  },
  "result": {
    "codeError": "none",
    "message": null,
    "status": "success",
    "x-request-id": "4d925d05e23f81170a7d899a482d2391"
  }
}

Описание полей структуры data:

Поле Тип Обязательное Описание
id string да Уникальный ID ордера в системе MoneyMania
status string да Статус ордера. См. статусную модель
merchantOrderID string нет ID ордера в системе мерчанта
currency string да Валюта ордера
amount float64 да Сумма ордера в валюте ордера
timer float64 да Таймер

Условия отправки callback-запросов#

Переход ордера в статусы (См. статусную модель):

  1. succeeded
  2. expired
  3. failed_by_terminal
  4. succeeded_by_appeal