Fires when a payment attempt fails. Use this event to trigger dunning workflows and identify at-risk subscriptions.
JavaScript
window._upstack('track', 'payment_failed', {
accountId: 'acct_abc123',
invoiceId: 'inv_ghi012',
subscriptionId: 'sub_def456',
amount: 9900,
failureReason: 'card_declined',
failureCode: 'insufficient_funds',
currency: 'USD'
});
Properties
| Property | Type | Required | Description |
|---|
| accountId | string | Yes | Account identifier |
| amount | number | Yes | Failed payment amount in cents |
| invoiceId | string | No | Invoice identifier |
| subscriptionId | string | No | Subscription identifier |
| failureReason | string | No | Failure reason code |
| failureCode | string | No | Detailed failure code |
| currency | string | No | ISO 4217 currency code |
When to Fire
- When card is declined
- When insufficient funds error occurs
- When Stripe
invoice.payment_failed webhook fires
Stripe Webhook
Maps to invoice.payment_failed.
Track payment failures to identify at-risk customers and trigger dunning workflows.
