Integration Guides

Adyen Gateway Configurations and Options

Suggest Edits

Overview

In addition to supporting Fraud at checkout, Forter's Magento2 integration can also support payment optimization recommendations for merchants using the Adyen payment gateway.\

Adyen Steps

Log into your Adyen admin panel and go to: Account => API URLs => Additional data in API response and toggle the following fields to be enabled:

  • Raw acquirer result
  • Cardholder name
  • Card bin
  • Card summary
  • Expiry date

🚧

Merchant Name

Make sure you select the corresponding Merchant Name in your Adyen account menu

You should also select the appropriate environment and Configuration ("Manual") in your Adyen settings as seen in the example below:

Pre-Auth Integration (no Payment Optimization Recommendations)

If you would like to receive a decision PRIOR to authorization or would like to receive a decision with a 3DS, PSD2, or Policy-specific recommendation, please follow the configuration steps below.

Go to the Forter Configuration option of your Magento Admin:Stores > Settings > Configuration > Forter > Configuration and then go to the Order Validation Settings section.

Select the following options from the two dropdown menus:

  • Order Validation Location: Before Payment Action (pre-authorization)
  • Action On Decline (pre-authorization): Show Payment Error to User (stay in checkout page with error message)

In the Custom Error Message (pre-authorization) text box, you can add a custom error message for declined customers.

Pre-Auth with 3DSecure/PSD2 Recommendations

  1. Expose Additional 3DS Data in Adyen - Go to your Adyen Dashboard , under Developers → Additional data → enable the fields under 3D Secure.
  1. In your Forter Magento2 Admin settings, you'll add mapping under the Advanced Settings
  2. 3DS Risk Recommendations - Forter's M2 extension inserts these parameters in your payment request and will override any Dynamic 3D Secure rules you have configured. More information can be found on the official Adyen documentation: https://docs.adyen.com/risk-management/dynamic-3d-secure/

  1. TRA Exemptions - Forter TRA resolution functionality has been integrated into the Adyen payment request according to Adyen guidelines. Merchants will need to activate the 3rd party/proprietary risk solution. To do this in the Adyen Dashboard follow these steps:

    1. Go to Risk > Risk Settings.
    2. Under General, find Perform Transaction Risk Analysis (TRA) for TRA exemption
    3. Select "Enable 3rd party/proprietary risk solution TRA" if you want to apply the TRA exemption manually for each transaction. If you prefer not to apply a TRA exemption at all, choose "Disable". More details here

  2. Forter 3DS Configurations - Go to the Forter Configuration option of your Magento AdminSelect the following options from the two dropdown menus:

    • Order Validation Location: Before Payment Action (pre-authorization)
    • Action On Decline (pre-authorization): Show Payment Error to User (stay in checkout page with error message)
  1. Handling Recommendations - When Forter sends a recommendation for an Adyen payment, it will be automatically stored in the order and can be viewed in the Sales Order Grid, specifically under the Forter Status column. Subsequently, when Magento sends the payment request to Adyen, the recommendations are included in the request and mapped to Adyen's 3D Secure and SCA (Strong Customer Authentication) Exemptions flow.

Post-Auth

Forter's Post-Auth configurations offer different actions that can be taken on the After Payment Action event in the Magento2 extension.

Go to the Forter Configuration option of your Magento Admin and then go to the Order Validation Settings section of your Forter M2 UI.

Select the After Payment Action option from the dropdown

Option 1: Authorize only with Forter capturing

FLOW:

Order is placed, payment is only authorized (configuration set to capture "manually")
After Adyen confirms authorization (1 minute after the checkout has ended), Forter will (up to another minute) make a decision to approve or decline.
If approved, Forter will Capture the funds and generate an invoice, in a way that both Magento and Adyen will be updated

👍

Good to Know:

This option is ideal for merchants who rely on the status set by the Adyen extension to export orders to their OMS.In this option the payment will remain authorized in Adyen and "pending" or a similar status in Magento, until Forter processes a decision and then captures the payment.

In Forter Configuration:

  • Order Validation Location: by Cron (must choose this field to work properly with Adyen payments)
  • Action On Decline: Cancel Order, Void or Refund Payments
  • Action On Not Reviewed: Create Invoice and Capture Payments (Recommended if Forter will not evaluate all of the Adyen methods)
  • Action On Approve: Create Invoice and Capture Payments

In the Adyen configuration in Magento, change the required settings to:

  • Capture Delay: manual
  • Order Status: We recommend you set "Pending" for Authorization and "Processing" for capture. Please verify your internal processes to choose these options properly.

In the Adyen admin portal:

Account -> Settings -> Capture Delay: This should reflect the option chosen on Magento, which is Manual.


Option 2: Adyen captures immediately

FLOW:

Order is Placed, payment is authorized and immediately captured (configuration in Adyen set to capture immediately)

  • After Adyen confirms Authorization+Capture, the order will be set to which ever status was chosen in Adyen config ("Processing" by default)
  • Forter will then (up to a minute) make a decision whether to approve or decline
  • In case of Decline, Forter will trigger a cancellation request to Magento and Adyen. The status in Magento will be "closed" and a credit memo will be created.
    • In Adyen, the status will be "refunded" or "sent to refund"

This option is ideal for merchants that don't rely only on "Processing" as the logic to export orders (and they can apply custom logic to only export orders not declined by Forter). Or merchants that rely on "Processing" as the only indication to export orders, but this process happen in a cron with more than 1 minute space, so that Forter will have time to cancel the order before it gets exported (In this case be aware of possible race conditions) In this option, all orders would be "Submitted to Settlement" in Adyen, "processing" in Magento and, if Forter declines an order, Forter would cancel the order in Magento and the payment will be canceled in Adyen a couple of minutes after.

Forter Configuration:

  • Order Validation Location by Cron (must choose this field to work properly with Adyen payments)
  • Action On Decline: Cancel Order, Void or Refund Payments
  • Action On Not Reviewed: Do Nothing
  • Action On Approve: Do Nothing

Adyen
In the Adyen configuration in Magento, change the required settings to:

  • Capture Delay: Immediate
  • Order Status: Default for merchant.

In the Adyen admin portal:

  • Account -> Settings -> Capture Delay: This should reflect the option chosen on Magento, which is Immediate.

Updated about 1 month ago