Загальна інформація щодо роботи системи

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

  • Кліент - клієнт інтеграції, від імені якого ведуться дії з 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 отримує від обробника і покупцеві повертаються гроші тільки за товар. Фінальний статус угоди