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

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