Документация

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

Если платеж создавался с параметром 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        | Нет              | Возвращенная покупателю сумма
В случае, если мерчант не подтверждает платеж в течение 2 часов с момента перевода в статус waiting_for_capture то платеж автоматически отменяется и деньги возвращаются на счет покупателя.