jhilden / commercetools-adyen-integration

commercetools-adyen-integration provides an integration between the commercetools and Adyen payment service provider based on the concept of Adyen Web Components.

commercetools-adyen-integration

commercetools-adyen-integration provides an Adyen Web Components based integration between the commercetools and Adyen PSP. Integration supports all the payment methods available as an Adyen Web Component. For a full list of all supported web component based payment methods please refer to supported payment methods.

Note: since the integration relies on the usage of Adyen's web components it does not need to process sensitive credit card data and thus is fully PCI DSS compliant.

• Overview
• Extension module
• Notification module
• Contribution Guide

Overview

This repository contains two standalone modules that interact with commercetools and Adyen. Complete integration requires running both of the modules.

1. Front end uses Adyen Web Components to present required payment methods. The list of available payment methods can be also obtained through the integration with the help of get available payment methods request. On user interaction, frontend web-component generates JSON payloads like make payment or submit additional payment data which has to be provided to commercetools payment as described here.
2. With help of the commercetools HTTP API Extensions provided data is sent to the Extension Module.
3. The Extension Module processes provided web component payload passed by the front end, exchanges it with Adyen API, and provides synchronous response back to the front end / commercetools caller. Based on result, the front end either creates an order or continues with further payment steps as described in the integration guide.

In addition with help of Adyen notifications any payment status changes are asynchronously exchanged between Adyen and commercetools.

Please follow the detailed guides below in order to integrate your front end with the Extension and Notification modules.

Extension module

The extension module is a publicly exposed service that acts as a middleware between the commercetools platform and Adyen. Once commercetools HTTP API Extensions is configured to call Adyen extension module, for every payment create or update request an Adyen extension will be remotely called by the commercetools platform.

• Follow Integration Guide for information how to integrate your shop with this module.
• Follow How to run the extension module.

Notification module

Notification module is a publicly exposed service which receives asynchronous notifications sent by Adyen, Through notifications, Adyen provides asynchronously payment status changes like authorization, charge, or refund of the payment. The notification module will process the notification and update the matching commercetools payment accordingly.

• Follow Integration Guide for information how to integrate with notification module.
• Follow How to run the notification module.

Contribution Guide

• Follow the Contribution Guide if you would like to run modules locally.