(Classic) Getting started with Adyen for PaymentHub

END-OF-LIFE ANNOUNCEMENT

This article describes Adyen integration with version 1 of the Payment API. The Classic Online Experience with Payment API version 1 will be decommissioned at the end of 2024. All Payment API integrations should migrate to version 2, the Enhanced Online Experience, by January 2025.

FinDock supports Adyen as Payment Service Provider.

Multi-merchant	Multi-currency

Payment Method	One-time	Recurring	Refunds
Bancontact
Credit Card
Ideal
Sofort

Pre-requisites

• FinDock installed and configured
• A source connector installed and configured
• The Adyen Integration permission set must be assigned to the site guest user
• A Salesforce Site configured

How to install, activate and configure Adyen

Follow the standard procedure for installing and activating the Adyen payment extension.

To configure Adyen:

1. Navigate to the FinDock setup page by opening the App Launcher (the 3×3 grid button on the top left of the page, just below the Salesforce cloud logo), enter “FinDock” in the search box and click the FinDock CPM app and select Setup in the navigation.
2. A red bullet is displayed near the tab Remote site settings, meaning that you have the remote site settings for Adyen. Open the tab and activate the remote site settings by toggling the button.
3. Click the Activate/Deactivate tab and locate the Adyen extension in the list (payment extensions are listed with category “PSP”). Activate Adyen. Now a button payment methods appears to activate the payment methods. Activate the wanted payment methods.

note

Regionally bound payment methods can only be used when the customer has an IP address in that region (Sofort can only be used in Germany)

4. After activating, go back to the set up screen and click on the Adyen tile. The Adyen setting screen will be displayed. Enter the url of your salesforce site and enter your Adyen data.

Now you can use our API for adyen payments and recurring credit card payments.

Single Payment

You can use our API to create a single payment for a customer. After receiving your message, a contact and outstanding installment is created in Salesforce and the API returns a redirect url where your customer can finish his payment. When the payment is correctly finished, the installment will be set to collected and a payment is added to the installment.

iDEAL example message

    {     
    "SuccessURL":"http://www.success.nl",
    "FailureURL":"http://www.fail.nl",
    "Payer":{
            "Contact":{
                "FirstName":"T",
                "LastName":"Tester",
                "Email":"Test@work.com"          
            },
            "AccountUpdate":"Enrich",
            "ContactUpdate":"Enrich",
            "AllowDeduplication":false,
            "PrimaryRelation":"Contact"
        },
        "Payment":{
            "Amount":21.23
        },
        "PaymentMethod":{
            "Name":"Ideal",
            "Processor":"PaymentHub-Adyen",
            "ParameterMap":{
                "Issuer":"ABN AMRO"
            }
                },
        "SourceConnector":{
            "Name":"PaymentHub"
        }
    }

email: obligatory for Adyen issuer: the customer's bank

Single credit card example

    {
    "SuccessURL":"success",
    "FailureURL":"failure",
    "Payer":{
            "Contact":{
                "FirstName":"H",
                "LastName":"Holle",
                "Email":"E@example.com"
            },
            "AccountUpdate":"Enrich",
            "ContactUpdate":"Enrich",
            "AllowDeduplication":false,
            "PrimaryRelation":"Contact"
        },
        "Payment":{
            "Amount":25.18
        },
        "PaymentMethod":{
            "Name":"CreditCard",
              "Processor":"PaymentHub-Adyen",
            "ParameterMap":{
                "cardType":"amex"
            }
                },
        "SourceConnector":{
            "Name":"PaymentHub"
        }
    }

New recurring credit card payments

To create a recurring credit card payment, the customer must do a first payment to collect correct details of the credit card. This initial payment is linked to the recurring payment in Salesforce. This gives the complete overview on the recurring payment. If the payment is successful the recurring payment will be completed with a payment profile for the credit card. New donations will be collected by a payment schedule.

Example recurring credit card payment with initializing payment

    {
     "SuccessURL":"http://www.success.nl",
     "FailureURL":"http://www.fail.nl",
     "Payer":{
            "Contact":{
                "FirstName":"Hartje",
                "LastName":"Hart",
                "Email":"B@xsforall.nl"    
            },
            "AccountUpdate":"Enrich",
            "ContactUpdate":"Enrich",
            "AllowDeduplication":true,
            "PrimaryRelation":"Contact"
        },
        "Recurring":{
            "Amount": 17.16,
            "Frequency":"Monthly",
            "StartDate":"2019-03-31"
        },
        "Payment":{
            "Amount": 17.16
        },
        "PaymentMethod":{
            "Name":"Creditcard",
            "Processor":"PaymentHub-Adyen",
            "ParameterMap":{
                "cardType":"visa"
            }     
        },
        "SourceConnector":{
            "Name":"PaymentHub"
        }
    }