Skip to content

Latest commit

 

History

History
148 lines (117 loc) · 5.93 KB

README.md

File metadata and controls

148 lines (117 loc) · 5.93 KB

Adyen Payment plugin for Magento 2

Use Adyen's plugin for Magento 2 to offer frictionless payments online, in-app, and in-store.

Integration

The plugin integrates card component (Secured Fields) using Adyen Checkout for all card payments. For Point Of Sale (POS) payments we use Terminal API using Cloud-based communication. Boleto and SEPA are a direct API integration into Adyen.

Support Vault and Instant Purchase

Inside Adyen toggle the following settings on inside the API and Responses section (Settings -> API and Responses):

  • Recurring details
  • Card bin
  • Card summary
  • Expiry date
  • Variant

Requirements

This plugin supports Magento2 version

  • 2.3.7 and higher
  • 2.4 and higher

Releases

  1. Major releases are done ONLY when absolutely required. We try to not to introduce breaking changes and do major releases as rare as possible. Current average is yearly.
  2. A minor or a patch release is scheduled but not limited to once every 2 weeks.

Note: This can be subject to change based on the load and dependancies of the Integration tools team.

Support & Maintenance

We provide three levels of support:

  1. Level 1 (12 months): full support (including new features) Keep in mind that some new features are not possible on older versions, therefore this is not inclusive of ALL new features that are built.
  2. Level 2 (12 months - 18 months): high priority bugs / security only.
  3. Level 3 (18 months - 24 months): security updates only (no support from support team).

After Level 3 there is no support or maintenance from Adyen and it should be treated as a native integration of the merchant.

The schedule for the current maintained branches is:

Plugin Major Version Release Date Level 1 Support ends Level 2 Support ends Level 3 Support ends
Version 6 March 2020 September 30 2021 March 31 2022 January 31 2023
Version 7 April 2021 September 30 2022 March 31 2023 September 30 2023
Version 8 November 2021 March 31 2023 September 2023 March 2024
Version 9 - 12 months after release 18 months after release 24 months after release

Or, visualised as a calendar:

gantt
    title Currently Supported Versions
    dateFormat  YYYY-MM-DD   
    section Version 6
    Level 1   :l61, 2020-03-31, 2021-09-30
    Level 2   :l62, after l61, 2022-03-31     
    Level 3   :l63, after l62, 2023-01-31
    section Version 7
    Level 1   :l71, 2021-04-09, 2022-09-30
    Level 2   :l72, after l71, 2023-03-31
    Level 3   :l73, after l72, 2023-09-30
    section Version 8
    Level 1   :l81, 2021-11-22, 2023-03-31
    Level 2   :l82, after l81, 2023-09-30
    Level 3   :l83, after l82, 2024-03-31
Loading

Contributing

We strongly encourage you to join us in contributing to this repository so everyone can benefit from:

  • New features and functionality
  • Resolved bug fixes and issues
  • Any general improvements

Read our contribution guidelines to find out how.

Installation

You can install our plugin through Composer:

composer require adyen/module-payment
bin/magento module:enable Adyen_Payment
bin/magento setup:upgrade

For more information see our installation section.

Documentation

Magento 2 documentation

Setup Cron

Make sure that your Magento cron is running every minute. We are using a cronjob to process the notifications (our webhook service) and to update Adyen servers' IP addresses. The cronjobs will be executed every minute.

<group id="adyen_payment">
    <job name="adyen_payment_process_notification" instance="Adyen\Payment\Model\Cron" method="processNotification">
        <schedule>*/1 * * * *</schedule>
    </job>
    <job name="adyen_payment_server_address_caching" instance="Adyen\Payment\Cron\ServerIpAddress" method="execute">
        <schedule>*/1 * * * *</schedule>
    </job>
</group>

The notification processing service queries the records that have been received at least 2 minutes ago. This is to ensure that Magento has created the order, and all save after events are executed. A handy tool to get insight into your cronjobs is AOE scheduler. You can download this tool through Magento Marketplace or GitHub.

If you need to setup your cronjob in Magento this is described here.

Verified payment methods

  • Card payment methods

    • Card payment method (non-3DS, 3DS1 and 3DS2)
    • One click payment methods (using Billing agreements or Vault)
    • Recurring payment methods (using Billing agreements or Vault)
  • Local payment methods

    • Afterpay
    • Apple Pay
    • Bancontact
    • Banktransfer IBAN
    • Doku
    • Google Pay
    • iDeal
    • Klarna
    • Oney
    • Zip
    • Multibanco
    • Konbini
    • Swish
    • MBway
    • Twint
    • Paypal
    • SEPA Direct Debit
    • PIX
    • Ratepay
    • Oxxo
    • Econtexts
    • PayBright
    • Blik

This is not an extensive list of all the supported payment methods but only the ones that have been already verified. In case you would like to see other payment methods in the list as well please contact us to verify those too.

Support

If you have a feature request, or spotted a bug or a technical problem, create a GitHub issue. For other questions, contact our support team.

API Library

This module is using the Adyen APIs Library for PHP for all (API) connections to Adyen. This library can be found here

License

MIT license. For more information, see the LICENSE file.