88 lines
3.2 KiB
Markdown
88 lines
3.2 KiB
Markdown
|
# Adyen
|
||
|
|
|
||
|
|
## Technical details
|
||
|
|
|
||
|
|
SDK: [Web Components](https://docs.adyen.com/online-payments/build-your-integration/?platform=Web&integration=Components)
|
||
|
|
version `5.39.0`
|
||
|
|
|
||
|
|
APIs:
|
||
|
|
|
||
|
|
- [Checkout API](https://docs.adyen.com/api-explorer/Checkout/) version `70`
|
||
|
|
- [Recurring API](https://docs.adyen.com/api-explorer/Recurring/) 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](https://docs.adyen.com/online-payments/build-your-integration/additional-use-cases/advanced-flow-integration)".
|
||
|
|
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`
|