Запрос pay

В случае успешного списания денежных средств с пользователя, процессинг PlatBox оповестит мерчанта, чтобы он мог зарегистрировать успешную транзакцию в своей системе и предоставить товары или услуги.

Подтверждение происходит по идентификатору транзакции, полученному на этапе резервирования. Необходимо понимать, что в случае неверного ответа от мерчанта, система будет переоповещать об успешной транзакции по политике переоповещения (политика переоповещения). Мерчант должен контролировать повторные запросы сам.

Пример запроса на подтверждение платежа:


    {
        "action": "pay",
        "platbox_tx_id": "42",
        "platbox_tx_created_at": "2014-10-12T00:13:37Z",
        "platbox_tx_succeeded_at": "2014-10-12T00:13:49Z",
        "merchant_tx_id": "1001",
        "merchant_tx_extra": {
            "pin_code": "17RT42"
        },
        "product": "legend_of_zelda",
        "payment" : {
            "amount": 10000,
            "currency": "RUB",
            "exponent": 2
        },
        "account": {
            "id": "player31337",
            "location": 4,
            "additional": "Jane Doe"
        },
        "order": "314542341",
        "merchant_extra": {
            "proc_code": 564
        },
        "payer": {
            "id": "**********"
        }
    }

Данный запрос отличается от check наличием в нем параметра platbox_tx_succeeded_at.

Поле в сообщении Комментарий
platbox_tx_succeeded_at Время перехода транзакции в статус успешной, в формате ISO 8601, UTC. Данная временная отметка важна для проведения финансовых сверок и разбора инцидентов

Если в системе мерчанта платёж был успешно зарезервирован на предыдущем шаге общения, процессинг PlatBox ожидает исключительно успешного выполнения данного запроса, с результатом вида:


    {
        "status": "ok",
        "merchant_tx_timestamp": "2014-10-12T04:13:45+04:00",
        "merchant_tx_extra": {
            "pin_code": "17RT42",
            "claim_code": "UNIHORNY"
        }
    }

Поле в сообщении Комментарий
status Результат операции, может содержать либо "ok", либо "error".
merchant_tx_timestamp Время подтверждения платежа в системе мерчанта.
merchant_tx_extra Объект с любой появившейся дополнительной информацией по данной транзакции.

Ошибка с соответствующим кодом ожидается только в одном из следующих случаев:

Код ошибки Описание
400 Неверный формат сообщения.
401 Некорректная подпись запроса.
406 Неверные данные запроса.
409 Значения полей запроса не соответствуют данным в системе мерчанта.
1000 Общая техническая ошибка.
2002 Платёж с указанным идентификатором уже отменён.
3000 Зарезервированная ранее транзакция устарела.