payment.failed
payment.failed надсилає Neocarts, коли списання за продовження підписки не вдалося: провайдер відхилив платіж (status: "failed") або платіж понад добу лишався в pending і його визнано простроченим (status: "expired"). Neocarts повторює спробу щодня, до пʼяти разів на одне замовлення на продовження; кожна невдала спроба — окрема подія з наростаючим attempt.
Пʼята невдача підряд ставить підписку на паузу: разом із payment.failed з next_attempt_at: null приходить subscription.paused з reason_key: "charge_failed".
Поля події
Section titled “Поля події”| Поле | Тип | Опис |
|---|---|---|
subscription_id |
string | Підписка, за яку йшло списання. |
attempt |
integer | Номер цієї невдалої спроби за поточне продовження, 1–5. |
max_attempts |
integer | Завжди 5. |
next_attempt_at |
string, ISO 8601, може бути null | Коли Neocarts спробує знову — через добу. null на пʼятій спробі: більше спроб не буде, підписка на паузі. |
Решта data — знімок платежу.
Приклад
Section titled “Приклад”Перша невдала спроба списання за продовження: картку відхилено, наступна спроба через добу.
{ "id": "019a0b7c-1f3e-7c1a-9c6e-0b9b1c2d3e52", "event": "payment.failed", "created_at": "2026-11-01T09:00:14+00:00", "shop_id": "7f3c2b1a-0d9e-4f8a-b7c6-d5e4f3a2b1c0", "data": { "id": "0199c0d1-2e3f-7a4b-8c5d-6e7f8a9b0c1d", "order_id": "0199c0d0-1d2e-7f3a-8b4c-5d6e7f8a9b0c", "provider": "plata-by-mono", "status": "failed", "amount": 231570, "refunded_amount": 0, "card_mask": "**** 4242", "card_brand": "visa", "created_at": "2026-11-01T09:00:12+00:00", "subscription_id": "0199a1b3-5e6f-7a8b-9c0d-1e2f3a4b5c6d", "attempt": 1, "max_attempts": 5, "next_attempt_at": "2026-11-02T09:00:14+00:00" }}На пʼятій спробі: "attempt": 5, "next_attempt_at": null, і тим же моментом — subscription.paused.
Що робити
Section titled “Що робити”- Нічого не скасовуйте після першої невдачі: Neocarts спробує ще — покупець теж отримує лист і може оновити картку.
- Якщо ви попереджаєте покупця самі, беріть дату з
next_attempt_at; приnull— повідомляйте про паузу, а не про наступну спробу. - Не рахуйте спроби самостійно — спирайтеся на
attemptіmax_attempts: повтор доставки з тим самимidнесе ті самі значення. - Паузу підписки обробляйте за
subscription.paused, а не заattempt: 5: порядок доставки двох подій не гарантований.
Повʼязані події
Section titled “Повʼязані події”subscription.paused— пʼята невдача підряд ставить підписку на паузу з reason_key charge_failedorder.created— замовлення на продовження, за яке йде списання
Заголовки запиту, підпис і повтори — в огляді; порядок подій — у послідовності подій.