payment_failed Event - Upstack Data

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	No	Account identifier
amount	number	No	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.

One invoice can fail several times. To mark when the account itself falls behind, track invoice_past_due once per invoice.