Enabling SEPA Direct Debit and iDEAL
SEPA Direct Debit and iDEAL allow you to accept recurring payments from customers through direct debit. To enable your SEPA Direct Debit and iDEAL credentials, you must generate and enable a webhook with Stripe. The process of generating a webhook differs depending on how your Stripe account was set up.
- Recharge Checkout on BigCommerce
- BigCommerce Checkout Integration
SEPA Direct Debit and iDEAL are not compatible with the Shopify Checkout Integration. You must use one of Shopify's eligible subscription payment processors.
Before you start
- This guide applies to merchants using the Recharge Checkout on BigCommerce or BigCommerce Checkout Integration. If you are using the Shopify Checkout Integration, SEPA Direct Debit and iDEAL are not compatible. You must have one of Shopify's eligible subscription payment processors enabled.
- Make sure to review the eligibility requirements before enabling SEPA Direct Debit and iDEAL.
- Since iDEAL relies on SEPA Direct Debit for recurring payments, both payment methods are added to your store at the same time. Once the feature is fully enabled, you have full control over which methods are available to customers during checkout.
- For merchants using the Recharge Checkout on BigCommerce, there is a delay between the charge settlement and order creation. At the checkout, Recharge creates a “pending” charge that can be settled in minutes for iDEAL payments but may take days for other SEPA payments to settle. Once the payment is settled and Stripe confirms it is successful, there can be up to a one-hour delay with the adapter capturing the new order and sending it to BigCommerce.
Stripe webhook
- SEPA Direct Debit is known as a delayed notification payment method, which means it can take some time to determine if the payment was successful. In most cases, this is between 24 to 48 hours, but it can take up to 14 days.
- Delayed notification payment methods do not provide an instant response regarding the payment transaction at checkout, which means an alternative method needs to be created to notify Recharge of the outcome of the transaction.
- To notify Recharge of the charge status for payments processed through SEPA Direct Debit, you must create a webhook on Stripe's side. Once the webhook is created, Recharge will receive payment transaction updates when they happen.
Determine the Stripe setup method used
The method used to enable SEPA Direct Debit and iDEAL will change depending on if you used OAuth or your Stripe API Keys to set up Stripe within Recharge.
To confirm which Stripe method was used:
- Select Settings in your merchant portal, and then select Payment.
- Refer to the Payment processor section to determine how Stripe was set up for your store.
Stripe connected via OAuth
If the Stripe account is connected with Stripe via OAuth, a message is displayed in the Payment processor section. Webhooks need to manually be created on Stripe if the account was connected via OAuth.
Stripe connected via API Keys
If the Stripe account is connected via API Keys, the Payment processor section displays a grey Connect with Stripe button. Webhooks can automatically be generated for accounts connected via Stripe's API keys.
Generate the webhook if Stripe was configured via OAuth
You will need to manually create the webhook on Stripe if OAuth was used to connect your Stripe account.
Recharge has provided additional information in the SEPA section of the Payment settings page (click Settings and select Payment) to assist with creating the webhook on Stripe. You will need to refer to this information as you generate the webhook.
- Endpoint URL - This is the webhook URL that Stripe uses to send Recharge updates about the payment. The Endpoint URL is store-specific, and can only be used for the store it is assigned to.
- Events to send - A list of events that Stripe should send to Recharge. All of these events must be configured for SEPA Direct Debit and iDEAL to work.
Step 1 - Create the webhook
-
Log into your Stripe Dashboard, click Developers, and select Webhooks.
-
Select +Add endpoint from the Endpoints receiving events from your account section. This will open an Add a webhook endpoint dialog.
-
Paste the Endpoint URL provided by Recharge in the Endpoint URL field.
- Enter a Description to explain why you are creating the endpoint for future reference.
- Select the events provided by Recharge from the dropdown menu under Events to send.
- Select Add endpoint to create the endpoint.
Step 2 - Capture the shared secret
A new screen will load once the webhook is created that shows the events selected when the endpoint was created.
The Signing secret is a secret string of numbers used to validate that an event was sent from Stripe, and must be provided to Recharge.
- In a new tab, log in to your merchant portal.
- Select Click to reveal under the Signing secret section to access the secret.
- Copy and paste the secret from Stripe into the Signing secret input field in your Payment settings in Recharge (click Settings and select Payment).
Keep the merchant portal open in a separate tab to finish completing the setup of your webhook.
Step 3 - Identify and capture the webhook ID
Navigate back to the webhook setting page in Stripe (the same page that contained the Signing secret) to access the webhook ID. The webhook ID is located after /webhooks/
in the URL of the webhook page, and begins with we_
.
we_
for the webhook ID. - Navigate back to your merchant portal tab.
- Copy the webhook ID and paste it into the Webhook ID field in your SEPA Payment settings in Recharge.
Step 4 - Generate the webhook
Once you've obtained the Signing secret and the Webhook ID from Stripe, you can complete the setup of your webhook.
- Confirm that both the Signing secret and Webhook ID are included under the SEPA section in your Recharge Payment settings page (click Settings and select Payment).
- Select Generate webhook & enable to configure the Stripe webhook.
If the webhook is successful, the status of the SEPA integration will change to Enabled.
Generate the webhook if Stripe was configured via API keys
The webhook can automatically be created on Stripe if the Stripe account was connected via API Keys.
Select Generate webhook & enable from the SEPA section of the Payment settings page (click Settings and select Payment).
This will automatically generate the webhook on Stripe and connect it to your Recharge account.
The webhook status will change to Enabled once the webhook is successfully generated, along with additional information about the webhook.
Enable SEPA Direct Debit and iDEAL at the checkout
Once the Stripe webhook has been created and generated, you can enable the payment methods at the checkout. It is possible to just enable one payment method, or use both at the same time.
- Select Storefront and select Checkout.
- Confirm if you would like to enable SEPA Direct Debit/iDEAL.
- Press Save to confirm your selection.