Adds additional card payment method details to Payment Records
What’s new
Payment Records now contain additional card payment method details in the payment_method_details.card hash:
- authorization_code : contains the authorisation code of the payment.
- description : provides a high-level description of the card types issued in this range.
- iin : contains the Issuer Identification Number of the card.
- instalments : includes the instalment details for this payment.
- issuer : specifies the name of the card’s issuing bank.
- network_advice_code : contains a two-digit code indicating the network’s advice for how to proceed with a payment declined error.
- network_decline_code : contains an alphanumeric code indicating the reason why the payment failed after the network declined the payment.
- stored_credential_usage : contains an enum value ( recurring or unscheduled ) that indicates the transaction type passed for an off-session, Merchant-Initiated Transaction.
Impact
These new properties provide access to more detailed information about card payments when reviewing Payment Records. Properties previously available only on the Charge object are now accessible from the Payment Record object when you analyse and process card payment data.
Changes
| Parameters | Change | Resources or endpoints |
|---|---|---|
| authorization_code description iin installments issuer network_advice_code network_decline_code stored_credential_usage | Added | PaymentAttemptRecord. payment_method_details. card PaymentRecord. payment_method_details. card |
Upgrade
- View your current API version in Workbench.
- If you use an SDK, upgrade to the corresponding SDK version for this API version.
- If you don’t use an SDK, update your API requests to include Stripe-Version: 2025-12-15. clover
- Upgrade the API version used for webhook endpoints .
- Test your integration against the new version.
- If you use Connect, test your Connect integration .
Learn more about Stripe API upgrades.