Adds buyer ID support for Bizum payments
What’s new
Adds the buyer_id property to the bizum hash on the Charge, PaymentAttemptRecord, PaymentRecord, and PaymentMethod objects. The buyer_id is a unique identifier that Bizum, a mobile payment method in Spain, assigns to the buyer. Stripe returns it on successful payments.
Impact
You can now read the buyer_id property from the bizum hash on the Charge, PaymentAttemptRecord, PaymentRecord, and PaymentMethod objects to uniquely identify the buyer in a Bizum transaction. Use this identifier to support fraud detection and risk management workflows in your integration.
Changes
| Parameter | Change | Resources or endpoints |
|---|---|---|
| buyer_id | Added | Charge. payment_method_details. bizum PaymentAttemptRecord. payment_method_details. bizum PaymentRecord. payment_method_details. bizum + 2 more ConfirmationToken. payment_method_preview. bizum PaymentMethod. bizum |
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
- Enables manual capture for Sunbit payments
- Adds buyer ID support for the related setting 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