Зафиксируйте заказ¶
Заказ может быть зафиксирован полностью или частично. Параметр amount должен быть передан в запросе на подтверждение списания (capture) и быть равен значению actual_amount заказа, если требуется полное подтверждение списания.
order actual_amount value if full capture is required.
Обратите внимание
Не допускается выполнение нескольких операций capture.
Правильная последовательность шагов для операции capture¶
Операция capture предназначена для списания суммы, ранее заблокированной на карте.
Блокировка должна выполняться с помощью запроса на предварительную оплату pre-payment request с параметром preauth = Y.
Этот платежный поток выполняется в два этапа. Первый этап — это платежная операция с предварительным блокированием суммы. Второй этап — это фиксация удержанной суммы.
Захват может осуществляться как на полную, так и на частичную сумму.
Note
Операции предварительной оплаты и подтверждения списания доступны только для способа оплаты картой. Другие способы оплаты не поддерживают эти операции, и полная сумма будет автоматически списана в соответствии с одноэтапным процессом:
Отмена предоплаты¶
Если операция capture еще не завершена, комиссия эквайера не взимается за операции предварительной оплаты и отмены.
Мгновенная отмена удержанной суммы происходит при выполнении отмены (reversal) для предоплаты.
Если операция capture еще не завершена, то доступна только отмена полной суммы удержания. Частичная отмена не допускается для предоплаты.
Если выполняется операция частичного списания, оставшаяся сумма будет автоматически возвращена на карту плательщика, и операция отмены больше не потребуется.
Пример
Например, если сумма предоплаты составляет 1000, а 200 необходимо отменить, то платеж должен быть зафиксирован на сумму 800. Остаток суммы в размере 200 не должен быть отменен, иначе сумма 200 будет отменена дважды.
Для операции предоплаты доступно только одно полное или частичное списание. Для операции с зафиксированным платежом доступно несколько последовательных частичных отмен.
Идемпотентный ключ захвата¶
Операция capture не требует идемпотентного ключа, поскольку capture можно безопасно повторить.
При повторной попытке capture с тем же идентификатором платежа (amount) возвращается текущий идентификатор платежа (capture_status).
Точка API для подтверждения заказа¶
Списать платеж
POST /api/capture/order_id
Эта точка API ожидает POST-запрос в формате JSON с параметрами запроса.
Обычный ответ будет содержать параметр capture_status, который указывает, было ли подтверждение списания успешным или нет.
Примеры запрос/ответ
curl -L 'https://pay.payme.uz/api/capture/order_id' \
-H 'Content-Type: application/json' \
-d '{
"request": {
"version": "1.0.1",
"order_id": "test_12343242113",
"currency": "UZS",
"merchant_id": 4056281,
"amount": 100,
"signature": "1efcb015c89da38977ae1e734aade413b95ca900"
}
}'
{
"response": {
"capture_status": "captured",
"order_id": "test_12343242113",
"response_description": "",
"response_code": "",
"merchant_id": 4056281,
"response_status": "success"
}
}
{
"response": {
"error_code": 1007,
"error_message": "Parameter `signature` is incorrect",
"request_id": "HGh7ami3WN0ci",
"response_status": "failure"
}
}