Set up a subscription with bank transfers

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.

To start, create a customer (either a customer-configured Account object or a Customer object) 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.

curl -X POST https://api.stripe.com/v2/core/accounts \
  -H "Authorization: Bearer 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
" \
  -H "Stripe-Version: $latestPreviewApiVersion" \
  --json '{
    "contact_email": "jenny.rosen@example.com",
    "display_name": "Jenny Rosen",
    "configuration": {
        "customer": {}
    },
    "include": [
        "configuration.customer"
    ]
  }'

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

• Set collection_method to send_invoice.
• Set days_until_due to configure how many days the customer has to pay the invoice.

curl https://api.stripe.com/v1/subscriptions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer_account={{CUSTOMER_ACCOUNT_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.

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.