This is an old revision of the document!
Table of Contents
- type:
- gateway
- name:
- Adyen
- countrie:
- US, CA, FR, DE, IT, NL, PL, RU, ES, SE, TR, GB, BR, MX, AU, CN, HK, IN, ID, JP, MY, PH, KR, TH
- support-added:
- 2.0.0
- auth-net-emulation:
- no
- supports-3dsecure:
- yes
- supports-multicurrency:
- yes
- gateway:
- https://www.adyen.com/
Adyen
Subscriptions are not supported with Adyen at this time. If you intend to sell subscriptions with your FoxyCart store, you will need to make use of another payment gateway.
Setting Up Adyen for FoxyCart
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.
Configuring Test Account
- In your browser, access the Adyen administration and login.
- Once you've logged in to the Adyen administration, click the “Skins” menu item on the left hand navigation, and click the “New” tab.
- Give the skin a description in the “Skin details”. For example, you could call it “FoxyCart”.
- Within the “Test & Live Configuration” section, click the green “Generate a new HMAC key” under “Test platform”.
- Copy the resulting HMAC key in the text field into your computers clipboard.
- Leave the Result URLs and Continue-to URLs fields blank.
- Scroll to the bottom and click “Create new skin on Test”.
- In a second tab in your browser, access your store's FoxyCart administration. Proceed to the “payments” section of the admin, and enable the “Accept payments using your Adyen account” option.
- In the “Secret Key” field, paste the HMAC key you copied earlier.
- Back in your Adyen administration tab, copy the “Skin Code” value. Switch over to the FoxyCart administration tab, and paste that into the corresponding “Skin Code” field.
- Finally towards the bottom of the page, look for the “Valid Accounts” section, and copy the name of the valid account shown there. In the FoxyCart administration tab, paste this value into the “Merchant Account” field. If there are multiple valid accounts shown, choose the one you want transactions from your FoxyCart store to be related to.
- Save the FoxyCart administration.
Configure Notifications
- In your Adyen administration, proceed to “Settings” and select the “Server Communication” option.
- In the list of notification options at the bottom of the page, click “Add” on the “Standard Notification” option.
- In the URL, enter a URL like
https://YOURSTORE.foxycart.com/ipn.php, but with your own FoxyCart store domain. For example, if your store domain wasmystore.foxycart.com, then the URL would behttps://mystore.foxycart.com/ipn.php. If you have a custom subdomain likesecure.mystore.com, then the URL would behttps://secure.mystore.com/ipn.php. - Leave “SSL Version” as “SSL”
- Check the “Active” checkbox
- Leave “Method” as “JSON”
- Leave the “Authentication” fields blank
- Scroll to the bottom and click “Save Configuration”
- If you want transactions to appear as pending for payments like iDEAL and bank transfer options until they're finally approved, you can also add the “Generic Pending Notification” option, following the same configuration as above.
- See the note below about the datafeed if you enable pending notifications
Testing Adyen
Once you've configured your account, we recommend running through some test transactions, especially with the countries and payment methods that you anticipate selling through.
Test Card Numbers
Review the test card numbers available from Adyen's documentation for testing payments.
Taking your Adyen account live
When you've finished testing, you can then take your Adyen account live, as detailed on this page of their documentation.
Once your account is live, you'll need to generate a new HMAC key for live servers.
Firstly though - if you haven't already, login to your store's FoxyCart administration and start your store's subscription from the dashboard.
- In the Adyen administration, click the “Skins” menu item on the left hand navigation, and select the skin you created earlier.
- Within the “Test & Live Configuration” section, click the green “Generate a new HMAC key” under “Live platform”.
- Copy the resulting HMAC key in the text field into your computers clipboard.
- Scroll to the bottom and click “Save skin”.
- In a new tab, login to your store's FoxyCart administration. Proceed to the “payments” section of the admin, and if not already, switch the servers to “Live Servers”. Enable the “Accept payments using your Adyen account” option.
- In the “Secret Key” field, paste the HMAC key you copied earlier.
- Same as with the test settings, copy the “Skin Code” from the Adyen skin settings into the “Skin code” field and the “Valid Accounts” name into the “Merchant Account” field in the FoxyCart payment settings.
Troubleshooting & Interpreting Response Codes
Contact Adyen for info. Know more? Feel free to edit this page with info.
Important Notes and Caveats
Possible Action: Datafeed Handling
This section only applies if you've enabled one of Adyen's “Pending” notification options
For delayed payment methods that Adyen offer like bank transfers, at the time of the customer completing the transaction - we don't necessarily know whether the transaction was completed yet or not. We instead rely on a notification from the gateway after the checkout has been completed to confirm whether the transaction was approved or not. To handle this, transactions are initially marked as pending, and when we get a confirmation from the gateway on the result of the transaction, we update it accordingly. Each time the status changes, a datafeed will be sent to your endpoint if configured with the transaction details and the status node will be present.
The status node can contain one of three different values: pending, approved or rejected. Depending on the types of actions you're needing to perform at your datafeed endpoint, you need to make sure the appropriate status value is present first.
User Notes and Experiences
If you have tips, experience, or helpful notes related to this gateway that would benefit others, please add them below, including your name and the date. We reserve the right to edit or remove comments that don't add value to this page.