Adyen

Overview

As outlined in the Validation overview, Forter requests information about the payment credit card being used for an order including:

credit card expiration Month

credit card expiration Year

credit card bin

credit card cvv Result/response (i.e. "M" for "Match", "X" for "no Match")

credit card avs Result/response (i.e. "M" for "Match" or "P" for "Pass")

Note that this data does NOT need to be saved in your SFCC storefront but can still be passed to Forter securely via the SFCC cartridge as Forter retains PCI-Level 1 compliance for all incoming server requests.

Enabling Additional Adyen Data in your Cartridge

In cases of Adyen client side encryption between submission and authorization, some of the above data points including credit card bin or card expiry may need to be manually enabled in your Adyen Admin panel. This can be done by logging into your Adyen admin panel and going to: Account => API URLs => Additional data in API response and toggling the following fields to be enabled:

Raw acquirer result

Cardholder name

Card bin

Card summary

Expiry date

Mapping Credit Card auth response to the Order.ds file

Depending on your SFCC architecture (controllers, SFRA, or pipelines), you will likely need to map the authorization response on the payment instrument to the Order.ds file

function ForterCreditCard(auth, cc) {
    var processorResponseCode = "",
        processorResponseText = "";

    // format the expiration month. from 1 to 01, etc.
    if (cc.creditCardExpirationMonth.toString().length == 1) {
        var creditCardExpMonth = "0" + cc.creditCardExpirationMonth.toString();
    } else {
        var creditCardExpMonth = cc.creditCardExpirationMonth.toString();
    }
    this.nameOnCard = cc.creditCardHolder;
    this.cardBrand = cc.creditCardType;

    if (cc.creditCardNumber.substring(0,6).indexOf('*') > -1) {
        this.bin = session.forms.billing.paymentMethods.creditCard.number.value.toString().substring(0,6);
    } else {
        this.bin = cc.creditCardNumber.toString().substring(0,6);
    }
    this.lastFourDigits = cc.creditCardNumberLastDigits;
    this.expirationMonth = card.expirationMonth.toString();
    this.expirationYear = card.expiryYear.toString();

    this.verificationResults = {};
    this.verificationResults.avsFullResult = auth.avsResultCode.toString();
    this.verificationResults.cvvResult = auth.cvcResultCode.toString();
    this.verificationResults.authorizationCode = auth.AuthorizationCode;

    this.paymentGatewayData = {};
    this.paymentGatewayData.gatewayName = "ADYEN_CREDIT"; // adjust based on your processor
    this.paymentGatewayData.gatewayTransactionId = auth.pspReference.toString(); // Adyen 16-digit psp reference value 

    processorResponseCode = auth();
    processorResponseText = auth.exact_message.toString();

    this.verificationResults.processorResponseCode = processorResponseCode;
    this.verificationResults.processorResponseText = processorResponseText; 
}