sincecutoff.com
/v1/json /v1/md llms.txt
← all changes

Stripe Top-ups accept US bank account PaymentMethods

Introduced 2026-07-29 · score 0.96

HOW TO USE IT

For US top-ups using the API version that adds PaymentMethod support, create the top-up with a `us_bank_account` PaymentMethod ID in `payment_method`. Optionally set `payment_method_options.us_bank_account.network`; it defaults to `ach`.

curl https://api.stripe.com/v1/topups \ -u "<YOUR_SECRET_KEY>" \ -H "Stripe-Version: 2026-07-29.dahlia" \ -d amount=<AMOUNT_IN_MINOR_UNITS> \ -d currency=<SUPPORTED_CURRENCY> \ -d payment_method=<US_BANK_ACCOUNT_PAYMENT_METHOD_ID> \ -d "payment_method_options[us_bank_account][network]=<NETWORK>"

WHY THIS HELPS

Create and manage US top-ups using the Payment Methods API.

BEFORE THIS CHANGE

Use the Sources API when creating and managing US top-ups.

REQUIREMENTS AND LIMITATIONS

  • amount (required): Positive integer amount to transfer.
  • currency (required): Lowercase supported three-letter ISO currency code.
  • payment_method: ID of the PaymentMethod to use; for this change, its type must be `us_bank_account`.
  • payment_method_options: Object containing top-up payment-method-specific configuration.
  • payment_method_options.us_bank_account.network: US bank transfer network; defaults to `ach`. The docs retrieved do not enumerate allowed values for this top-up parameter.
  • Prerequisite: Use API version `2026-07-29.dahlia` or later for this behavior. For REST requests, Stripe's upgrade instructions say to send the version in the `Stripe-Version` header.
  • Applies to top-ups in the US.
  • Currently supports only `us_bank_account` payment method types.

FIRST-PARTY EVIDENCE

Check the installed version and the source before using it. Entry JSON

Report a problem with this card