Setup
Please follow the common Adyen instructions to get set up with SEPA. Next, make sure to enable SEPA as a payment method on your configured account.Usage
To create a SEPA payment, set themethod
to sepa
when calling our transaction API.
Recurring payments
SEPA via Adyen supports recurring payments. To process a recurring payment, please be aware of the following limitations when storing a SEPA payment method for future use.- To store a SEPA payment for future use, set
store: true
on the transaction request. - When stored, a SEPA payment method is initially in a
processing
state until we receive a webhook from Adyen. You will need to set up the AdyenRECURRING_CONTRACT
webhooks for us to receive this update. - A stored SEPA payment method in a
processing
state can not be used in Embed until it is ready and marked assucceeded
- SEPA supports the
payment_source
ofrecurring
andinstalment
, which will map toSubscription
on the Adyen API. In all other scenarios it will set the recurring processing mode asUnscheduledCardOnFile
. - Until the first transaction is settled, a stored SEPA payment will use a different mandate for the subsequent request. In a production environment, this might lead to a subsequent payment failing if the original mandate has not been fully settled yet.
Auto-rescue
Adyen’s auto-rescue feature is supported by this connector. This feature will automatically retry customer-not-present direct debit transactions when they receive a chargeback. To enable this feature, pass in the following connection options for Adyen when making a subsequent payment request.Plase note that this feature only works for customer-not-present transaction where
is_subsequent_payment
is set to true
.autoRescue
- A boolean value that enables the feature. This defaults tofalse
.maxDaysToRescue
- The rescue window, in days. You can specify between 1 and 42 days. Adyen recommends using a rescue window of one calendar month (30 days).autoRescueScenario
- This is one of the test scenarios as defined by Adyen. This will only work in sandbox.ownerName
- Set this to the type of chargeback that you want to simulate. Use a concatenation of chargeback and the reason code. For example,chargeback:MS03
orchargeback:AM04
. This will only work in sandbox.
capture_succeeded
in our system as the payment
will always be processed successfully initially. Instead, the auto-rescue will fight the chargeback by re-attempting the payment.
Our system will not report on this attempts, but we may report the chargeback in our settlement reports.