Setup

Please follow the common Adyen instructions to get set up with Adyen.

Features

After setting up an Adyen account we recommend you configure the following things in the developer area so you can use all features. Go to Developers -> Additional data in the Adyen dashboard and then make sure the following fields are selected.
  • Recurring Details
  • Raw acquirer result
  • Payment account reference

Auto-rescue

Adyen’s auto-rescue feature is supported by this connector. This feature will automatically retry customer-not-present card transactions when they are declined on the first request. To enable this feature, pass in the following connection options for Adyen when making a subsequent payment request.
POST /transactions

{
    "amount": 1299,
    "country": "US",
    "currency": "USD",
    "intent": "capture",
    "payment_method": {
        "method": "id",
        "id": "7f6fb9ca-eb1c-42c6-9b65-8f1c699b84bd"
    },
    "connection_options": {
        "adyen-card": {
            "autoRescue": true,
            "maxDaysToRescue": 5
        }
    },
    "payment_source": "card_on_file",
    "is_subsequent_payment": true,
    "merchant_initiated": true
}
Please note that this feature only works for customer-not-present transaction where is_subsequent_payment is set to true.
The following fields will need to be set.
  • autoRescue - A boolean value that enables the feature. This defaults to false.
  • maxDaysToRescue - The rescue window, in days. You can specify between 1 and 48 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. Please be aware that the webhooks from Adyen in these test scenarios may take a few minutes to arrive.
We will mark a transaction as processing when a transaction has been accepted for automatic retries using this feature. When we receive a webhook for a successful payment or an eventual rejection, we will update the status accordingly.
For auto-rescue to work it’s important to ensure Adyen has been setup to send webhooks in a JSON format.

Canceling auto-rescue

While a payment is in the rescue process, the buyer may provide a new payment method or reach out to cancel their subscription. In these scenarios, the rescue process can be canceled. To cancel the auto-rescue process, perform a cancel request on the transaction. Once Adyen has processed the cancellation and we have received confirmation via webhook, the transaction will be marked as canceled.

Balance splits

Adyen’s balance splits feature is supported by this connector. This feature allows you to determine where to book the funds at transaction time. Please note you can configure your users’ stores to automatically split all transactions. This means that you do not need to send these split instructions in every payment or capture request. To enable this feature, pass in the following connection options for Adyen when making a payment request.
POST /transactions

{
    "amount": 4000,
    "country": "US",
    "currency": "USD",
    "intent": "capture",
    "payment_method": {
        ...
    },
    "connection_options": {
        "adyen-card": {
            "splits": {
                "authorization": [
                    {
                        "account": "MARKETPLACE_ACCOUNT1",
                        "amount": {
                            "currency": "USD",
                            "value": 200
                        },
                        "description": "Marketplace fee",
                        "reference": "YOUR_UNIQUE_REFERENCE1",
                        "type": "BalanceAccount"
                    },
                    {
                        "account": "MARKETPLACE_ACCOUNT2",
                        "amount": {
                            "currency": "USD",
                            "value": 200
                        },
                        "description": "Remainder",
                        "reference": "YOUR_UNIQUE_REFERENCE2",
                        "type": "Remainder"
                    },
                ],
                "capture": [...],
                "refund": [...]
            }
        }
    }
}
You can define the split information to be set at time of authorization, capture, or even for refunds. Please note you can use the PUT /transactions/{id} API to update connection options (and therefore splits) before making a capture or refund. Please refer to Adyen’s balance splits documentation for exact details on each of the split objects.

Payouts / Original Credit transactions

Adyen Transfers API is supported by this connector to enable Payouts/Original Credit Transactions. This feature needs to be enabled in your Adyen “account” for it to work. You will also need to provide a balance account id in the configuration of your Adyen connection in the dashboard. Your payouts will be funded from this balance account.