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
}

Plase 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.