Статусы¶
В этой статье мы расскажем о жизненном цикле операции пополнения.
Жизненный цикл пополнения с банковской карты¶
Рассматривается жизненный цикл пополнения с карты из авторизованной зоны.
flowchart TD
Start --> PROCESSING
Start --> errorCode
PROCESSING --> SUCCESS
PROCESSING --> DECLINED
Партнёр отправляет запрос на пополнение. BaaS возвращает партнёру один из ответов:
- HTTP 200 OK и
status:PROCESSING
— когда данные из запроса прошли валидацию и другие внутренние проверки (операция создана, ожидается поступление денежных средств с банковской карты клиента); - HTTP 4xx/5xx и
errorCode
— когда данные не прошли валидацию или другие внутренние проверки (операция не создана, причина указана вerrorCode
и описана справочником кодов ошибок). Необходимо изменить данные в запросе и повторить попытку.
Если операция находится в статусе PROCESSING
и клиент подтвердил платёж на форме QIWI, она переходит в одно из финальных состояний:
SUCCESS
— внутренние проверки пройдены, счёт клиента пополнен;DECLINED
— внутренние проверки не пройдены, счёт клиента не был пополнен. Детализацию статусаDECLINED
см. в документации Payments API.
Если операция находится в статусе PROCESSING
и клиент не подтвердил платёж на форме QIWI в течение установленного lifeTime
, она принимает финальный неуспешный статус DECLINED
.
Если на каком-либо этапе жизненного цикла операции пополнения партнёр получил ошибку (errorCode
), её необходимо интерпретировать согласно справочнику кодов ошибок, обработать и затем возобновить работу с операцией, если ошибка не является фатальной и её можно устранить.
Жизненный цикл пополнения c другого кошелька¶
Жизненный цикл операции пополнения c другого кошелька аналогичен жизненному циклу операции выплаты средств на кошелёк.