Adds support for in-person payment methods, including Interac cards
What’s new
Allows for better handling and differentiation of in-person transactions made with card_present or interac_present payment methods.
Added
card_present.description nullable string
A high-level description of the type of cards issued in this range. (For internal use only and not typically available in standard API requests.)
Added
card_present.issuer nullable string
The name of the card’s issuing bank. (For internal use only and not typically available in standard API requests.)
Added
card_present.brand_product nullable string
The product code that identifies the specific program or product associated with a card.
Added
card_present.network_transaction_id nullable string
This is used by the financial networks to identify a transaction. Visa calls this the Transaction ID, Mastercard calls this the Trace ID, and American Express calls this the Acquirer Reference Data. The first three digits of the Trace ID is the Financial Network Code, the next 6 digits is the Banknet Reference Number, and the last 4 digits represent the date (MM/DD). This field will be available for successful Visa, Mastercard, or American Express transactions and always null for other card brands.
Impact
This change allows you to access specific details related to these transaction types.
Changes
| Parameters | Change | Resources or endpoints |
|---|---|---|
| issuer description brand_product network_transaction_id | Added | Charge. payment_method_details. card_present |
| issuer description network_transaction_id | Added | Charge. payment_method_details. interac_present |
| issuer description brand_product | Added | PaymentMethod. card_present |
| issuer description | Added | PaymentMethod. interac_present |
| network_transaction_id brand_product | Added | ConfirmationToken. payment_method_preview. card. generated_from. payment_method_details. card_present PaymentMethod. card. generated_from. payment_method_details. card_present |
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: 2024-09-30. acacia
- Upgrade the API version used for webhook endpoints .
- Test your integration against the new version.
- If you use Connect, test your Connect integration .
- In Workbench, perform the upgrade . You can roll back the version for 72 hours.
Learn more about Stripe API upgrades.
Related changes
- Adds option to retrieve CVC tokens on Confirmation Tokens
- Adds customer ID to payment method preview on a confirmation token
- Adds support for identifying the unique payer for the the related setting payment method
- Adds support for Affirm transaction IDs
- Displays
authorization_codefor Charges - Adds wallet details for
card_presentCharges and Payment Methods - Adds country field for Charges that use Klarna
- Displays Amazon Pay dispute type on Disputes