Перейти до вмісту

payment.failed

payment.failed надсилає Neocarts, коли списання за продовження підписки не вдалося: провайдер відхилив платіж (status: "failed") або платіж понад добу лишався в pending і його визнано простроченим (status: "expired"). Neocarts повторює спробу щодня, до пʼяти разів на одне замовлення на продовження; кожна невдала спроба — окрема подія з наростаючим attempt.

Пʼята невдача підряд ставить підписку на паузу: разом із payment.failed з next_attempt_at: null приходить subscription.paused з reason_key: "charge_failed".

Поле Тип Опис
subscription_id string Підписка, за яку йшло списання.
attempt integer Номер цієї невдалої спроби за поточне продовження, 1–5.
max_attempts integer Завжди 5.
next_attempt_at string, ISO 8601, може бути null Коли Neocarts спробує знову — через добу. null на пʼятій спробі: більше спроб не буде, підписка на паузі.

Решта data — знімок платежу.

Перша невдала спроба списання за продовження: картку відхилено, наступна спроба через добу.

{
"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.

  • Нічого не скасовуйте після першої невдачі: Neocarts спробує ще — покупець теж отримує лист і може оновити картку.
  • Якщо ви попереджаєте покупця самі, беріть дату з next_attempt_at; при null — повідомляйте про паузу, а не про наступну спробу.
  • Не рахуйте спроби самостійно — спирайтеся на attempt і max_attempts: повтор доставки з тим самим id несе ті самі значення.
  • Паузу підписки обробляйте за subscription.paused, а не за attempt: 5: порядок доставки двох подій не гарантований.
  • subscription.paused — пʼята невдача підряд ставить підписку на паузу з reason_key charge_failed
  • order.created — замовлення на продовження, за яке йде списання

Заголовки запиту, підпис і повтори — в огляді; порядок подій — у послідовності подій.