Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Основные сущности

...

Словник термінів

  • Кліент - клієнт інтеграції, від імені якого ведуться дії з Escrow Box, для доступа к сервису ему выдаются авторизационные данные (логин и пароль). Также, ему настраивается доступ к определенным платежным системам и обработчикам, которые он может использовать при создании обьявления и сделки
  • Объявление - предзаполненные данные продавца, доставки и товара, которые могут использоваться при создании сделки
  • Корзина - группирующий элемент для сделок
  • Сделка - основная сущность, которая  отображает текущее состояние сделки. Сделка в себе содержит состояние оплаты за товар и обработчик, который содержит состояние доставки товара, также обработчик содержит оплату за доставку товара
  • Обработчик - интеграция EscrowBox с внешней системой обработки сделки, то есть доставки товара. Может быть любой логист, например, доступу до сервісу йому видаються авторизовані дані (логін і пароль). Також йому надається доступ до певних платіжних систем і обробників, які він може використовувати при створенні оголошення та угоди
  • Оголошення-  попередньо заповнені дані продавця, доставки та товару, які   можуть використовуватися при створенні угоди
  • Кошик - елемент для групування угод
  • Сделка -  основна сутність, яка відображає поточний стан самої угоди.  Угода в собі містить інформацію про оплату товару та обробника, який в свою чергу містить статус  доставки товару та дані про оплату за доставку товару
  • Обробник - інтеграція EscrowBox із зовнішньою системою обробки угоди, тобто доставки товару. Може бути будь-який логіст, наприклад: служба доставки "Нова Пошта"
  • Платежная Платіжна система - интеграция EscrowBox с внешней платежной системой, которая обрабатывает платежи и сохраняет деньги на этапе проведения сделки. Может быть любая платежная система, например, ECOM и P2P платежи от UAPAY

Основные этапы создания сделки

...

  • інтеграція EscrowBox із зовнішньою платіжною системою, яка обробляє платежі і зберігає гроші на етапі проведення угоди. Може бути будь-яка платіжна система, наприклад: ECOM та P2P платежі від UAPAY

Основні етапи створення угоди 

Процес створення та проведення угоди можно розділити на основні етапи:

Section


Column
width50%


  • Этап создания и подтверждения объявления - этап, в котором создается, наполняется определенными данными, а так же подтверждается объявление. Он является не обязательным и может быть пропущен, в зависимости от flow клиента-интегратора. Нужно понимать, что объявление является многоразовым и, например, при продаже такого же товара, не требуеться создавать его повторно 
  • Этап создание корзины - этап в котором нужно создать корзину, так как при создании сделки обязательно нужно указать ID корзины. На данном этапе реализации самой системы Escrow Box, кроме как создания корзины, с ней ничего нельзя сделать, но в будущем функционал будет добавлен
  • Этап создания, оплаты, подтверждения сделки (до отправки товара)  - этап на котором создается, наполняется данными, оплачивается (подразумевает также  подтверждения платежей), подтверждается (подразумевает создание ТТН в системе обработчика) сделка, а так же отправляется сам товар
  • Этап трекинга системой Escrow Box обработчика (после отправки товара) - заверщающий этап на котором Escrow Box трекает систему обработчика и ожидает получить определенные статусы доставки товара для принятия решений по сделке. На этом этапе на сделку влияет только обработчикЕтап створення та підтвердження оголошення: - етап, на якому створюється, наповнюється певними даними, а також підтверджується оголошення. Він є не обов'язковим і може бути пропущений залежно від flow клієнта-інтегратора. Потрібно розуміти, що оголошення є багаторазовим і, наприклад, при продажу такого самого товару не потрібно створювати його повторно
  • Етап створення кошика - етап, на якому потрібно створити кошик, так як при створенні угоди обов'язково потрібно вказати ID кошика. На даному етапі реалізації самої системи Escrow Box, окрім як створення кошика, з нею нічого не можна зробити, але в майбутньому функціонал буде додано
  • Етап створення, оплати, підтвердження угоди (до відправки товару)  - етап, на якому створюється, наповнюється даними, оплачується (в тому числі підтверджуються платежі), підтверджується (мається на увазі створення ТТН в системі обробника) угода, а так же відправляється сам товар
  • Етап трекінга системою Escrow Box обробника (після відправки товару) - завершальний етап, на якому Escrow Box відслідковує систему обробника і очікує отримати певні статуси доставки товару для прийняття рішень по угоді. На цьому етапі на угоду впливає тільки обробник


Column




Section


Column
width60%

  


Column
Статусы и поведение системы от их смены

Статуси та поведінка системи

  • "NEW" - начальный   початковий статус сделкиугоди, ставиться встановлюється по умолчанию замовчуванню при создании сделкистворенні угоди
  • "PAID" - сделка угода оплачена, переходит  переходить в этот цей статус только при успешной оплате платежей тільки при успішній оплаті платежів за товар и і за доставку, платежи должны быть в статусе платежі повинні бути в статусі "PAID"
  • "CONFIRMED" - сделка подтвержденаугода підтверждена, создан створена ТТН в системе обработчика для отправки товара, переходит в этот статус при подтверждении сделкисистемі обробника для відправки товару. Переходить в цей статус при підтвержденні угоди
  • "SENT" - товар отправленвідправлено, сделка переходит угода переходить в этот цей статус , когда обработчик сообщит Escrow Box о том, что товар отправлен, при этом дальше Escrow Box не влияет на состояние сделки, просто трекаеться обработчик и в соответсвии ответов о состоянии доставки товара принимаються решенияв момент, коли обробник повідомить Escrow Box про те, що товар відправлено. Надалі Escrow Box не має впливу на стан угоди, він відслудковує обробника і залежно від його відповідей про стан доставки товару приймає рішення
  • "DELIVERED" - товар прибыл, сделка переходит в этот статус, когда обработчик сообщит Escrow Box о том, что товар прибыл прибув в пункт призначення. Угода набуває цього статусу, коли обробник повідомить Escrow Box про те, що товар прибув в пункт призначення
  • "FINISHED" - товар был забран получателем, деньги був отриманий одержувачем, гроші за товар зачисляются продавцузараховуються продавцеві, а за доставку обработчику, сделка переходит в этот статус, когда обработчик сообщит Escrow Box о том, что товар был принят получателем. Конечный статус сделки- обробнику. Угода набуває це статус, коли обробник повідомляє Escrow Box про те, що товар був отриманий одержувачем. Фінальний статус угоди
  • "EXPIRED" - истекло время ожидания на определенное действие, если сделка перешла в этот статус со статусов час очікування на певну дію було вичерпано. Якщо угода перейшла в цей статус із статусів "PAID" (истекло время на подтверждение сделки минув час на підтвердження угоди - 2 днядні) или або "CONFIRMED" (истекло время на отправку товара минув час на відправку товару - 7 днейднів) , это означает что товар еще не был отправлен, значит покупателю возвращаються деньги за товар и за доставку. Если сделка перешла в этот статус с статуса "DELIVERED"(истекло отведенное время на то, что бы забрать товар, у каждого обработчика свое время), об этом Escrow Box узнает от обработчика, это означает, что товар уже был доставлен, значит покупателю возвращаються деньги только за товар. Конечный статус сделки"REJECTED" - переходит в этот статус, если была произведена неудачная оплата, если один из платежей уже был оплачен успешно, он возвращаеться. Так же сделка может омениться с помощью метода отмены, его можна вызвать, только пока товар не отправлен, это статусы сделки - це означає, що товар ще не був відправлений і гроші за товар та доставку повертаються покупцеві. Якщо угода перейшла в цей статус із статусу "DELIVERED" (сплив відведений час на те, щоб забрати товар: у кожного обробника це свій проміжок часу),  цю інформацію Escrow Box отримує від обробника -  це означає, що товар вже був доставлено і покупцеві повертаються гроші лише за товар. Фінальний статус угоди
  • "REJECTED" - угода набуває цього статусу, якщо була проведена невдала оплата. У випадку, якщо один з платежів вже був оплачений успішно, він повертається. Також угода може отримати цей статус за допомогою методу скасування. Цей метод можна викликати лише до моменту відправки товару - це статуси угоди: "NEW", "PAID", "CONFIRMED" этом случае, если уже есть оплаченые платежи, они возвращаются). Так же, сделка переходит в этот статус, когда получатель отказываеться от товара, об этом Escrow Box узнает от обработчика, значит покупателю возвращаються деньги только за товар. Конечный статус сделкицьому випадку, якщо вже є оплачені платежі, вони повертаються). Ще угода переходить в цей статус, коли одержувач відмовляється від товару, - цю інформацію Escrow Box отримує від обробника і покупцеві повертаються гроші тільки за товар. Фінальний статус угоди