Skip to content
Create account
 or
Sign in
The Stripe Docs logo
/
Create account
Sign in
Overview
Billing
OverviewAbout the Billing APIs
Subscriptions
Tax
Overview
Reporting
OverviewReports for multiple accounts
Data
OverviewSchema

Set up a subscription with bank transfers

Learn how to create and charge for a subscription with bank transfers.

Use this guide to set up a subscription using bank transfers as a payment method.

Create a product and price
Dashboard
Server-side

Products and Prices are core resources for Subscriptions. Create a product and a recurring price. Save the price ID—you’ll need it later in this guide.

Create or retrieve a customer
Server-side

To start, create a customer with a valid email address, if one doesn’t already exist. The valid email address ensures that the customer can receive invoices you send to them. Funds from bank transfers are held in the customer’s cash balance, so you have to associate a Customer object with each bank transfer subscription.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node
Go
.NET
No results
curl https://api.stripe.com/v1/customers \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d name="Jenny Rosen" \
  --data-urlencode email="jenny.rosen@example.com"

Create the subscription
Server-side

Create the subscription using the customer ID and price ID from the previous steps.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node
Go
.NET
No results
curl https://api.stripe.com/v1/subscriptions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer={{CUSTOMER_ID}} \
  -d "items[0][price]"={{PRICE_ID}} \
  -d collection_method=send_invoice \
  -d days_until_due=30 \
  -d "payment_settings[payment_method_types][0]"=customer_balance

An invoice is sent to the customer when the Subscription is due. The invoice is marked as paid if the customer has enough funds in their cash balance. Otherwise, it contains the necessary information needed for the customer to push funds from their bank account. This invoice also has a link to the Hosted Invoice Page. Subsequent invoices use the price you created in the first step.

Learn more about bank transfer invoices.

Test your integration

Use the Stripe Dashboard or CLI to simulate an inbound transfer of funds.

As soon as you receive a fund, Stripe performs automatic or manual reconciliation of the invoice.

Was this page helpful?
YesNo