Подтверждение или отмена платежа
Если платеж создавался с параметром auto_capture = false, то после перехода платежа в состояние waiting_for_capture сервис Eight ожидает от мерчанта подтверждения или отмены платежа.
В случае если подтверждение или отмена платежа мерчанта не была выполнена в рамках ответа на нотификацию мерчанта сервисом Eight (запрос на notify_url сервисом Eight) то мерчант должен выполнить подтверждение или отмену платежа собственным запросом к системе Eight.
Формат запроса:
URL: https://secure.eight.uz/set_accept
Метод: POST
Content-type: application/json
Тело запроса:
{
"merchant_shop_id": 1,
"merchant_secret": "29586cd6-b18d-4262-8ec5-26eb13b941c3",
"payment_UUID": "82e74a8e-df8c-49cd-8635-e1a8d933c5a7",
"accept_status": "capture",
"final_amount": 100000
}
Описание полей запроса:
Поле | Обязательное | Описание
:--------------- | :----------: | ---------------------------------------:
merchant_shop_id | Да | Уникальный ID мерчанта (доступен в ЛК мерчанта)
merchant_secret | Да | Персональный секретный ключ мерчанта, который генерируется в ЛК мерчанта.
Должен содержаться в безопасной недоступной зоне сайта мерчанта.
payment_UUID | Да | Уникальный идентификатор транзакции в ПС Eight.
accept_status | Да | Может принимать значения:
capture - подтвердить платеж
cancel - отменить платеж
final_amount | Нет | Уменьшенная финальная сумма платежа
В ответ на запрос мерчанта ПС Eight отвечает следующим JSON в теле ответа:
{
"error": 0,
"status": "succeeded",
"shop_transaction_id": "uniq shop transaction_id",
"payment_UUID": "82e74a8e-df8c-49cd-8635-e1a8d933c5a7",
"pay_url": "https://gateway.eight.uz/182e74a8e-df8c-49cd-8635-e1a8d933c5a7"
}
Описание полей ответа Eight:
Поле | Обязательное | Описание
:----------------- | :---------------:| ---------------------------------:
status | Да (если error=0)| Статус платежа в системе Eight, один из:
created - платеж создан
canceled - платеж отменен
wait_user_action - ожидает действий пользователя
waiting_for_capture - платеж авторизован и ожидает подтверждения мерчантом
succeeded - платеж успешно выполнен
payment_UUID | Да (если error=0)| Уникальный идентификатор транзакции в ПС Eight.
shop_transaction_id| Да (если error=0)| Уникальный идентификатор транзакции на стороне мерчанта.
pay_url | Да (если error=0)| URL совершения платежа в ПС Eight.
error | Да | Код ошибки. Варианты:
0 - нет ошибок
1 - ошибка формата данных
2 - ошибка авторизации
4 - внутренняя ошибка сервиса
10 - Не удалось сменить статус платежа
11 - платеж с указанным payment_UUID не найден
errorMessage | Нет | Детальное описание ошибки
transfer_sum | Нет | Сумма по счету за вычетом комиссии Eight,
доступная для возврата средств покупателю
refunded_sum | Нет | Возвращенная покупателю сумма