Понимание системы статусов и подстатусов сделок — фундамент успешной интеграции с PayShark.io. Каждая сделка или выплата в системе проходит через последовательность состояний, и правильная обработка каждого из них определяет, насколько автоматизированным и надежным будет ваш бизнес-процесс. В этой статье разберем полную систему статусов PayShark.io, их значение и правильную обработку на стороне мерчанта.
Система статусов сделок (Order Statuses)
Каждая сделка в PayShark.io имеет два уровня состояния: status — общий статус, и sub_status — детальный подстатус, уточняющий общее состояние. Такой двухуровневый подход позволяет точно определить, на каком этапе находится сделка и какие действия требуются от мерчанта или клиента.
Общие статусы (Status)
- pending — сделка находится в обработке, ожидает действий от участников. Это начальное состояние для всех новых сделок.
- success — сделка успешно завершена, все обязательства выполнены, средства переведены.
- fail — сделка завершилась неудачей, средства не были переведены или были возвращены.
Детальные подстатусы (Sub Status)
- pending — начальное состояние, сделка только создана, реквизиты еще не предоставлены.
- accepted — сделка принята системой, начат поиск подходящих реквизитов.
- waiting_for_payment — реквизиты предоставлены клиенту, система ожидает перевода от него. На этом этапе клиент должен перевести средства на указанные реквизиты в течение времени резервирования.
- successfully_paid — платеж успешно зачислен на счет трейдера, система проверяет корректность поступления.
- successfully_paid_by_resolved_dispute — оплата подтверждена после разрешения спора администратором.
- fully_completed — сделка полностью завершена, все средства переведены, никаких дальнейших действий не требуется.
- waiting_details_to_be_selected — система ожидает выбора типа реквизитов для оплаты.
- waiting_for_dispute_to_be_resolved — по сделке открыт спор, ожидается решение администратора.
- canceled_by_dispute — сделка отменена по результатам спора в пользу одной из сторон.
- expired — срок действия сделки истек, клиент не перевел средства в течение установленного времени.
- cancelled — сделка отменена мерчантом или системой по иным причинам.
Система статусов выплат (Payout Statuses)
Выплаты также имеют двухуровневую систему статусов:
- pending — выплата создана, ожидает обработки.
- processing_by_trader — трейдер обрабатывает выплату, средства резервируются.
- processing_by_administrator — выплата обрабатывается администратором (обычно при превышении лимитов).
- fully_completed — выплата успешно завершена, средства получены адресатом.
- cancelled — выплата отменена.
Подстатусы для выплат:
- waiting_for_trader — ожидание подтверждения от трейдера.
- processing_by_trader — трейдер обрабатывает выплату.
- processing_by_administrator — администратор проверяет выплату.
- dispute — по выплате открыт спор.
Правильная обработка статусов на стороне мерчанта — ключ к автоматизации бизнес-процессов. При получении successfully_paid рекомендуется немедленно подтверждать заказ или активировать услугу. Статус waiting_for_payment означает, что клиенту нужно показать реквизиты и ожидать перевода. При статусе expired или cancelled — отменять заказ и уведомлять клиента. При dispute — приостанавливать выполнение и подключать службу поддержки.
Понимание полной системы статусов позволяет построить надежную и полностью автоматизированную систему обработки платежей на базе PayShark.io.
