Save the related setting Direct Debit details for future payments
Learn how to save payment method details for future the related setting Direct Debit payments.
Checkout
Elements
Mobile
You can use Checkout in setup mode to collect the related setting Direct Debit payment details in advance, and determine the final amount or payment date later. Use it to:
- Save payment methods to a wallet to streamline future purchases
- Collect surcharges after fulfilling a service
- Start a free trial for a subscription
Note
the related setting Direct Debit is a delayed notification payment method, which means that funds aren’t immediately available after payment. A payment typically takes 5 business days to arrive in your account.
Create or retrieve a customer Server-side
To reuse a the related setting Direct Debit payment method for future payments, attach it to an object that represents your customer.
Use the Accounts v2 API to represent customers
The Accounts v2 API is generally available for Connect users, and in public preview for other Stripe users. If you’re part of the Accounts v2 preview, you need to specify a preview version in your code.
To join the Accounts v2 preview, go to Account previews and features in your Dashboard and enable Reusable payment methods for Global Payouts.
For most use cases, we recommend modeling your customers as customer-configured Account objects instead of using Customer objects.
Create a customer-configured Account or Customer when your customer creates an account with your business, or when saving a payment method. Associate the object’s ID with your own internal representation of a customer.
Create a new customer or retrieve an existing one to associate with this payment.
Command Line
Select a language
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
Set up future payments
Note
This guide builds on the foundational set up future payments Checkout integration.
Enable the related setting Direct Debit as a payment method
Enable the related setting Direct Debit in your Dashboard. Stripe automatically displays the related setting Direct Debit to eligible customers using dynamic payment methods. If you currently specify payment_method_types, see the migration guide.
Command Line
Select a language
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
Test your integration
You can test your integration using the IBANs below. The payment method details are successfully collected for each the related setting but exhibit different behavior when charged.
Test IBANs
Use these test IBANs with the Payment Element to test your the related setting Direct Debit integration. The Payment Element automatically validates the the related setting and displays the mandate when you enter one of these test values.
| Account Number | Token | Description |
|---|---|---|
the related setting | pm_sepaDebit_success_at | The PaymentIntent status transitions from processing to succeeded. |
the related setting | pm_sepaDebit_successDelayed_at | The PaymentIntent status transitions from processing to succeeded after at least three minutes. |
the related setting | pm_sepaDebit_failed_at | The PaymentIntent status transitions from processing to requires_payment_method. |
the related setting | pm_sepaDebit_failedDelayed_at | The PaymentIntent status transitions from processing to requires_payment_method after at least three minutes. |
the related setting | pm_sepaDebit_disputed_at | The PaymentIntent status transitions from processing to succeeded, but a dispute is immediately created. |
the related setting | pm_sepaDebit_exceedsWeeklyVolumeLimit_at | The payment fails with a charge_exceeds_source_limit failure code due to payment amount causing account to exceed its weekly payment volume limit. |
the related setting | pm_sepaDebit_exceedsWeeklyTransactionLimit_at | The payment fails with a charge_exceeds_weekly_limit failure code due to payment amount exceeding account's transaction volume limit. |
the related setting | pm_sepaDebit_insufficientFunds_at | The payment fails with an insufficient_funds failure code. |
the related setting | Payment method creation fails with a bank_account_unusable error. Use a different bank account or payment method. Applies to SetupIntents and PaymentIntents that include inline the related setting data. |