Adds payment method and payment method options to the Top-ups API (US bank accounts only)
What’s new
Two optional parameters are now available on the create a top-up endpoint:
- payment_method : The ID of a PaymentMethod object to use for the top-up. Currently only supports us _ bank _ account payment method types.
- payment_method_options : An object for payment method-specific configuration for the us _ bank _ account payment method type.
Impact
You can now fund a top-up from a US bank account using the Payment Methods API. Pass a Payment Method object ID of type us_bank_account in the payment_method parameter when you create a top-up. Use payment_method_options to configure payment method-specific behaviour.
Changes
| Parameters | Change | Resources or endpoints |
|---|---|---|
| payment_method payment_method_options | Added | Topup#create |
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 .
Learn more about Stripe API upgrades.