Adds support for WeChat Pay and Affirm on TerminalPublic preview

What’s new

Adds support for Terminal when using WeChat Pay and Affirm Charge by including additional fields on the payment_method_details. You can also specify a return_url for non-card payments in Terminal server-driven integrations.

Impact

Lets you collect WeChat Pay and Affirm payments in-person on Terminal smart readers. Learn more about additional payment methods on Terminal.

Changes

Parameters	Change	Resources or endpoints
locationreader	Added	Charge.payment_method_details.affirm Charge.payment_method_details.wechat_pay PaymentAttemptRecord.payment_method_details.affirm + 3 more PaymentAttemptRecord.payment_method_details.wechat_pay PaymentRecord.payment_method_details.affirm PaymentRecord.payment_method_details.wechat_pay
confirm_config	Added	Terminal.Reader#confirm_payment_intent Terminal.Reader.action.confirm_payment_intent
return_url	Added	Terminal.Reader#process_payment_intent.process_config Terminal.Reader.action.process_payment_intent.process_config

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-05-28.preview
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.