Stripe Top-ups API accepts US bank account payment methods
Introduced 2026-06-24 · score 0.97
HOW TO USE IT
When creating a top-up funded by a US bank account, pass its `us_bank_account` PaymentMethod ID as `payment_method`; use `payment_method_options` for payment-method-specific configuration. Both parameters are optional.
curl https://api.stripe.com/v1/topups \
-u "<YOUR_SECRET_KEY>" \
-H "Stripe-Version: 2026-06-24.dahlia" \
-d amount=2000 \
-d currency=usd \
-d payment_method=<PAYMENT_METHOD_ID> \
-d payment_method_options[<DOCUMENTED_OPTION>]=<VALUE>WHY THIS HELPS
Fund a top-up from a US bank account using the Payment Methods API.
REQUIREMENTS AND LIMITATIONS
- amount (required): Positive integer amount to transfer.
- currency (required): Lowercase three-letter ISO currency code; must be supported.
- payment_method: PaymentMethod ID; a PaymentMethod of type `us_bank_account` can be used.
- payment_method_options: Object for payment-method-specific configuration for this top-up. Sub-keys and allowed values were not found in the accessible reference.
- Both parameters are optional.
- Currently only `us_bank_account` payment method types are supported.
FIRST-PARTY EVIDENCE
- https://docs.stripe.com/changelog/dahlia/2026-06-24/top-ups-payment-method-support-for-us-bank-accounts
- https://docs.stripe.com/api/topups/create?api-version=2026-06-24.dahlia
Check the installed version and the source before using it. Entry JSON