Adyen

Supported payment methods

Adyen support a whole host of different payment methods that can be enabled for your account. All are supported on the Foxy checkout except for Klarna and RatePay. Klarna can be supported for your store with our native integration.

The options actually displayed to customers are determined by Adyen based on what you have enabled on your account and where the customer is based.

Only a subset of their supported payment methods are compatible with subscriptions. You can review their supported payment methods on their website.

Setting up Adyen

You'll gather four values from Adyen: an API key, a client key, your merchant account code, and a webhook HMAC key.

Get your API key and client key

1. 1

   Log in to the Adyen administration.

2. 2

   Click Developers in the navigation, and select API credentials.

3. 3

   Select the ws@Company.[YourCompanyAccount] option from the users list.

4. 4

   Under Authentication, click Generate New API Key and copy the API key that's displayed.

5. 5

   Click Save at the bottom of the page.

6. 6

   Still viewing the same user, go to Client settings and copy the Client key, generating one if there isn't one already.

7. 7

   Still within Client settings, make sure your Foxy store subdomain has been added to the Add allowed origins list:

   • If you're using a default *.foxycart.com subdomain, enter it like https://mystore.foxycart.com

   • If you're using a custom subdomain, enter that instead, like https://checkout.mystore.com

8. 8

   Save the changes.

Get your merchant account code

1. 1

   In the Adyen administration, under Account in the top navigation, select Merchant accounts.

2. 2

   Copy the Account Code for the merchant account you want to use with your Foxy store.

Create a webhook and generate your HMAC key

1. 1

   In the Adyen administration, go to Developers and then Webhooks.

2. 2

   Click Create new webhook.

3. 3

   In the list of webhook types, click Add on the Standard webhook option.

4. 4

   In the URL field, enter a URL like https://YOURSTORE.foxycart.com/ipn.php using your own store domain. If your store domain is mystore.foxycart.com, the URL is https://mystore.foxycart.com/ipn.php. If you have a custom subdomain like secure.mystore.com, the URL is https://secure.mystore.com/ipn.php.

5. 5

   Leave Method as JSON.

6. 6

   Leave Encryption protocol as TLSv1.3.

7. 7

   Set Security > Authentication method to No authentication.

8. 8

   Under HMAC, click Generate to generate a new HMAC key, and copy it.

9. 9

   Leave the events selected as default, but make sure the list includes at least AUTHORISATION, CANCELLATION, CAPTURE and REFUND.

10. 10

    Scroll to the bottom and click Save Configuration.

Add a pending webhook for redirect payment methods

If you offer redirect payment methods like iDEAL or bank transfer, add a second webhook as well. The Standard webhook does not send the PENDING event, so without this Foxy has no way to mark those transactions as pending while they await approval.

1. 1

   In the Adyen administration, go to Developers and then Webhooks, and click Create new webhook again.

2. 2

   This time choose the Generic pending webhook option.

3. 3

   Point it at the same ipn.php URL you used for the Standard webhook, and configure it the same way.

4. 4

   Save the configuration. See Possible action: datafeed handling below for what your endpoint will receive.

Enter your credentials in Foxy

1. 1

   Go to the Foxy admin and go to Settings > Payments.

2. 2

   Open or create a payment method set, then click Add payment method + and choose Adyen.

3. 3

   Under Live setup, enter your Merchant Account code, API key, Client key and Webhook HMAC key. This setup only takes effect once Use live credentials is turned on for the payment method set.

4. 4

   Under Test setup, enter the equivalent values from your Adyen test account.

5. 5

   Turn on Show Credit Card form to show the card form on the checkout.

6. 6

   Turn on Authorize only (do not capture funds) if you want to authorize payments without capturing them immediately.

7. 7

   Click Create, or Save if you're editing an existing entry.

Testing

Obtaining a test account

You can obtain a test account from Adyen on their website at adyen.com/signup. After completing the application you'll receive an email with details on accessing your test account.

Once you've configured your account, we recommend running through some test transactions, especially with the countries and payment methods you anticipate selling through.

Test card numbers

Review the test card numbers available from Adyen's documentation.

Taking your Adyen account live

When you've finished testing, you can take your Adyen account live by working through Adyen's go-live checklist.

Your test setup is not copied over to your live Adyen account, so you'll need to generate a new API key, a new client key and a new HMAC key against your live account, and create the webhooks again there.

Before that, if you haven't already, log in to your Foxy administration and start your store's subscription from the dashboard.

Enter those live values under Live setup on the Adyen entry in your payment method set, then turn on Use live credentials for that set.

Troubleshooting & interpreting response codes

Contact Adyen for info.

Important notes and caveats

Possible action: datafeed handling

For delayed payment methods that Adyen offer, like bank transfers, we don't necessarily know at the time the customer completes the transaction whether it was completed. We rely on a notification from the gateway afterwards to confirm whether it was approved. Transactions are initially marked as pending, and we update them when the gateway confirms the result.

Each time the status changes, a datafeed is sent to your endpoint if configured, with the transaction details and a status node. The status node contains one of three values: pending, approved or rejected. Depending on what your endpoint does, make sure you check for the appropriate status value first.