Основные сущности
- Клиет - клиент интеграции от имени которого ведутся действия с Escrow Box, для доступа к сервису ему выдаються авторизационные данные(логин и пароль). Так же, ему настраиваються доступ к определенным платежным системам и обработчикам, которые он может использовать при создании обьявления и сделки
- Объявление - предзаполненные данные продавца, доставки и товара, которые могут используются при создании сделки
- Корзина - группирующий элемент для сделок
- Сделка - основная сущность, которая и отображает текущее состояние сделки. Сделка в себе содержит состояние оплаты за товар и обработчик, который содержит состояние доставки товара, так же обработчик сожержит оплату за доставку товара
- Обработчик - интеграция EscrowBox с внешней системой обработки сделки, то есть доставки товара. Может быть любой логист, например, служба доставки "Нова Пошта"
- Платежная система - интеграция EscrowBox с внешней платежной системой, которая обрабатывает платежи и сохраняет деньги на этапе проведения сделки. Может быть любая платежная система, например, ECOM и P2P платежи от UAPAY
Основные этапи создания сделки
Процесс создание и выполнения сделки можно поделить на основные этапы:
- Этап создания и подтверждения объявления - этап в котором создается, наполняеться определенными данными, а так же подтверждается объявление, он является не обязательным и может быть пропущен, в зависимости от flow клиента-интегратора. Нужно понимать, что объявление являеться многоразовым и например при продаже такого же товара, не требуеться создание его снова
- Этап создание корзины - этап в котором нужно создать корзину, так как при создании сделки обязательно нужно указать ID корзины. На данном этапе реализации самой системы Escrow Box, кроме как создания корзины, с ней ничего нельзя сделать, но в будущем функционал будет добавлен
- Этап создания, оплаты, подтверждения сделки, до отправки товара - этап на котром создается, наполняеться данными, оплачиваеться(подразумевает так же возможное подтверждения платежей), подтверждаеться(подразумевает создание ТТН в системе обработчика) сделка, а так же отправляеться сам товар
- Этап трекинга системой Escrow Box обработчика, после отправки товара - заверщающий этап на котором Escrow Box трекает систему обработчика и ожидает получить определенные статусы доставки товара для принятия решений по сделке. На этом этапе на сделку влияет только обработчик
Статусы и поведение системы от их смены
- "NEW" - начальный статус сделки, ставиться по умолчанию при создании сделки
- "PAID" - сделка оплачена, переходит в этот статус только при успешной оплате платежей за товар и за доставку, платежи должны быть в статусе "PAID"
- "CONFIRMED" - сделка подтверждена, создан ТТН в системе обработчика для отправки товара, переходит в этот статус при подтверждении сделки
- "SENT" - товар отправлен, сделка переходит в этот статус, когда обработчик сообщит Escrow Box о том, что товар отправлен, при этом дальше Escrow Box не влияет на состояние сделки, просто трекаеться обработчик и в соответсвии ответов о состоянии доставки товара принимаються решения
- "DELIVERED" - товар прибыл, сделка переходит в этот статус, когда обработчик сообщит Escrow Box о том, что товар прибыл
- "FINISHED" - товар был забран получателем, деньги за товар зачисляются продавцу, а за доставку обработчику, сделка переходит в этот статус, когда обработчик сообщит Escrow Box о том, что товар был принят получателем. Конечный статус сделки
- "EXPIRED" - истекло время ожидания на определенное действие, если сделка перешла в этот статус со статусов "PAID"(истекло время на подтверждение сделки - 2 дня) или "CONFIRMED"(истекло время на отправку товара - 7 дней), это означает что товар еще не был отправлен, значит покупателю возвращаються деньги за товар и за доставку. Если сделка перешла в этот статус с статуса "DELIVERED"(истекло отведенное время на то, что бы забрать товар, у каждого обработчика свое время), об этом Escrow Box узнает от обработчика, это означает, что товар уже был доставлен, значит покупателю возвращаються деньги только за товар. Конечный статус сделки
- "REJECTED" - переходит в этот статус, если была произведена неудачная оплата, если один из платежей уже был оплачен успешно, он возвращаеться. Так же сделка может омениться с помощью метода отмены, его можна вызвать, только пока товар не отправлен, это статусы сделки "NEW", "PAID", "CONFIRMED"(в этом случае, если уже есть оплаченые платежи, они возвращаются). Так же, сделка переходит в этот статус, когда получатель отказываеться от товара, об этом Escrow Box узнает от обработчика, значит покупателю возвращаються деньги только за товар. Конечный статус сделки