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