Adds buyer ID support for the related setting payments
What’s new
Adds the buyer_id property to the blik hash on the PaymentMethod object and to the payment_method_details.blik hash on the SetupAttempt object. The buyer_id property is a unique merchant-scoped identifier that helps identify the specific account holder making the payment.
The buyer_id property was previously available only on Charges.
Impact
You can now access buyer identification information for the related setting PaymentMethods and SetupAttempts through the buyer_id property. This additional data point can help you:
- Implement sophisticated fraud detection rules
- Meet compliance requirements for payment monitoring
- Correlate payments from the same customer across multiple transactions and payment methods
The buyer_id property is read-only and populated automatically when provided by the related setting. No changes to your existing the related setting payment integration are required.
Changes
| Parameter | Change | Resources or endpoints |
|---|---|---|
| buyer_id | Added | ConfirmationToken. payment_method_preview. blik PaymentMethod. blik |
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: 2026-06-24. dahlia
- 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 buyer ID support for Bizum payments
- Enables manual capture for Sunbit payments
- Adds a fingerprint to Pix payment method details
- Adds transaction link ID to card payment method details for Mastercard and Maestro transactions
- Adds payment method options for Sunbit in Checkout Sessions
- Adds support for the Sui network and USDsui token for crypto payments
- Adds support for Mastercard compliance disputes
- Adds support for recurring payments with Satispay