Private preview
Consumer Credit Issuing webhook events Private preview
Understand webhook events sent during a Consumer Credit Issuing integration.
Use webhook events and GET calls to understand changes that occur to API objects in your Consumer Credit Issuing integration.
Connected account
| Event | Description |
|---|
| Account created or KYC updated | /v1/accounts is synchronous. Rely on the API response directly. |
| account.updated | Stripe deactivates the card_issuing_consumer_revolving_credit_card_celtic capability if it detects abnormal activity on the account, such as fraud. |
| issuing.credit_underwriting_record.updated | Sent for any updates to credit underwriting records, including regulatory changes, credit limit increases, rejected applications, and completion of underwriting. |
| issuing_credit_policy.created | Sent when a credit policy is created for the connected account. |
| issuing_credit_policy.updated | Sent when a credit policy’s APR, credit limit, or status changes (for example, suspended for nonpayment or closed). |
Example account.updated payload for a capability change:
{
"object": {
"id": "acct_123",
"object": "account",
"capabilities": {
"card_issuing_consumer_revolving_credit_card_celtic": "inactive"
}
}
}
Example issuing_credit_policy.updated payload for a status change:
{
"id": "icpo_123",
"object": "issuing.credit_policy",
"credit_limit_amount": 1000,
"credit_limit_currency": "usd",
"credit_period_ends_on_days": [28],
"credit_period_interval": "month",
"credit_period_interval_count": 1,
"days_until_due": 25,
"livemode": false,
"status": "suspended",
"status_reasons": {
"platform_controlled": [
{
"from_credit_underwriting_record": "cur_123",
"type": "suspected_fraud_pending_investigation"
}
],
"stripe_controlled": []
},
"type": "revolving",
"upcoming_attributes": null
}
Card
When a card is reported lost or stolen, the behavior depends on who initiates the replacement:
- If the consumer requests a new card through your platform, cancel the existing card and create a new card object. See Replace a card .
- If the consumer contacts Stripe support directly, Stripe handles the API calls. In both cases, issuing _ card. updated and issuing _ card. created are triggered.
Funding obligation
The platform account sends funding obligation webhooks because they relate to the platform’s obligations to Stripe for the issuing program.
Payment method
Credit repayment
Transaction
Dispute
The issuing.dispute object represents the dispute state machine but doesn’t represent money movements. To track the money movement of disputes, use credit_ledger_entries.
Credit statement
| Event | Description |
|---|
| issuing_credit_statement.created | Sent at the beginning of each billing cycle, representing the opening of the statement period for the consumer. |
| issuing_credit_statement.finalized | Sent at the end of the billing cycle when the statement is finalized. The event object includes a statement_pdf URL. Also sent when the statement becomes past due. |
Finance charges
Balance category
| Event | Description |
|---|
issuing.credit_balance_category.created | Sent when a balance category is created for a consumer’s credit policy, typically at credit policy activation time. |
issuing.credit_balance_category.updated | Sent when a balance category is updated. Listen to this event to detect prime rate changes. |
