Строк сесії та остаточне підтвердження
Як розрізняти строк оплати сесії v2, своєчасний переказ та остаточність.
Цей посібник про платіжні сесії v2, а не про життєвий цикл рахунків v1. Використовуйте повернений для сесії expiresAt і поточні реквізити спроби. Строк фіксований: вибір іншого маршруту, повторне відкриття оплати чи повтор запиту його не подовжують. Приклад не гарантує універсальні 30 хвилин.
До вказаного строку
Надішліть один переказ у вказаній мережі й токені, на збережену адресу та рівно на відображену суму. Потрібне допустиме включення до блокчейну до строку; натискання кнопки надсилання до кінця таймера нічого не доводить. Ураховуйте час надсилання з гаманця та включення до мережі. Гарантованої тривалості підтвердження немає; прийняття переказу точно на межі строку не обіцяється.
Не округлюйте, не розбивайте переказ і не використовуйте старі реквізити. Інша сума чи токен можуть не зіставитися або стосуватися іншого відповідного платежу. Зміна маршруту не перетворює попередній переказ на оплату щойно вибраного маршруту.
Коли таймер завершився
Припиніть надсилання коштів. Сторінка приховує реквізити для оплати, але таймер сам собою не доводить відсутності платежу. Своєчасно включений переказ може ще чекати підтвердження чи обробки. EXPIRED не означає автоматично остаточний неоплачений результат.
Отримайте GET /v2/payment-sessions/:id зі свого сервера, використовуючи секрет потрібних проєкту й режиму. Перевіряйте серверний стан разом із monitoringComplete та isFinal: вони описують моніторинг мережі й незавершені підтвердження та обробку. Не замінюйте їх таймером браузера чи параметром повернення. Обробка може завершитися після вікна оплати.
Лише перевірена payment_session.paid та авторизована відповідь сесії PAID, що збігається зі збереженими замовленням, проєктом, режимом, валютою й ціною, дозволяють одноразове виконання. Використовуйте повну процедуру підтвердження. Переможна спроба може відрізнятися від відображеного маршруту; її дочірній рахунок не є другою оплатою замовлення.
Пізні, додаткові й нерозглянуті перекази
Пізні спостереження можуть відображатися як LATE_PAYMENT, додаткові зіставлені квитанції — як ADDITIONAL_PAYMENT. Вони потребують перевірки й не дозволяють повторного виконання. Моніторинг після оплати не гарантує виявлення й відображення кожного майбутнього переказу. Незіставлений запис reviewCandidates не доводить оплати й може стосуватися іншого замовлення.
Якщо покупець уже надіслав кошти, не створюйте заміну автоматично й не просіть повторний переказ або доплату різниці. Зберіть номер сесії чи замовлення, мережу та хеш, порівняйте зі збереженою спробою й дотримуйтеся розгляду проблем оплати. Підтримка досліджує стан, але не гарантує прийняття помилкового чи пізнього переказу. Будь-яке повернення погоджується з продавцем.