Odoo18-Base/addons/payment_adyen

Adyen

Technical details

SDK: Web Components version 5.39.0

APIs:

• Checkout API version 70
• Recurring API version 68

This module relies on the Web Components SDK to render payment methods and their payment detail inputs on the payment form. The JS and CSS assets of the SDK are loaded directly from the __manifest__.py file.

When a Web Component needs to fetch/push information from/to Adyen or when a payment operation (e.g., refund, offline payment) is executed from the backend, a server-to-server API call is made to the appropriate API endpoint.

This combined solution allows the implementation of a good-quality direct payment flow whilst keeping the front-end development efforts low. The 3DS support is also entirely delegated to Adyen.

This is achieved by following Web Components' "Advanced flow". It is preferred over the recommended "Sessions flow" that only requires dealing with the /sessions endpoint instead of three /payment/* endpoints because two of those are still required to implement tokenization and handle 3DS redirects.

Supported features

• Direct payment flow
• Webhook notifications
• Tokenization with or without payment
• Full and partial manual capture
• Full and partial refunds

Not implemented features

• Express checkout

Module history

• 17.0
  • The Web Drop-in SDK is replaced by the Web Components SDK (version 5.39.0); the Checkout and Recurring APIs are updated to versions 70 and 68. odoo/odoo#120446
  • The 'Checkout API URL' and 'Recurring API URL' fields are replaced by the 'API URL Prefix' field. odoo/odoo#126831
• 16.4
  • The responses of webhook notifications are sent with the proper HTTP code. odoo/odoo#117940
• 16.2
  • The support for partial manual capture is added. odoo/odoo#87251
• 16.0
  • Archiving a token no longer deactivates the related payment method on Adyen. odoo/odoo#93774
• 15.3
  • The support for manual capture is added. odoo/odoo#70591
• 15.2
  • An HTTP 404 "Forbidden" error is raised instead of a Validation error when the authenticity of the webhook notification cannot be verified. odoo/odoo#81607
• 15.0
  • The support for both full and partial refunds is added. odoo/odoo#70881
  • The Web Drop-in SDK is migrated to version 4.7.3 and the Checkout API to version 67 to switch from relying on origin keys and use client keys instead. odoo/odoo#74827
• 14.3
  • The previous Hosted Payment Pages API that allowed for redirect payments is replaced by a combination of the Web Drop-in SDK (version 3.9.4) and the Checkout (version 53) and Recurring (version 49) APIs. odoo/odoo#141661

Testing instructions

https://docs.adyen.com/development-resources/testing/test-card-numbers/

VISA

Card Number: 4111111145551142

Expiry Date: 03/30

CVC Code: 737

3D Secure 2

Card Number: 5454545454545454

Expiry Date: 03/30

CVC Code: 737