Connect to Adyen

This guide outlines the necessary steps to connect your Pagos and Adyen accounts. For more information on connecting Pagos to other payment processors, see our Connecting Your Payment Processors to Pagos guide.

Step 1 - Configure Reports in Your Adyen Account

🚧

Be sure to configure all of your MIDs

The same reports need to be configured for all of the MIDs you connect to your Pagos account. This ensures the maximum data visibility necessary.

Log into your Adyen account to configure a set of automatic reports:

  1. Click the company name in the top-left corner of the page, then select the proper merchant account from the drop-down menu. This is vital, as these reports are enabled per merchant account and give us the ability to capture the maximum number of details. Save this Merchant ID for future use.
  2. Click Reports in the left-side navigation panel.
  3. For each of the following reports, click the name of the report to open its settings; click Manage report, then Automatic (generate on as schedule). Turn Automatic generation on and select .CSV for the File type:
    1. 3D Secure Authentication
    2. Aggregate settlement details
    3. Dispute transaction details
    4. Interchange and Scheme Fee report
    5. Payment Accounting Report
    6. Received payment details
    7. Settlement details

Step 2 - Create a Report User in Your Adyen Account

Follow the instructions outlined in Adyen's documentation to create a new API credential in your Adyen account for use in your Pagos account. For the Credential type, select Report service user.

Save the following information for future use:

  • Under General settings, save the Username.
  • Under Server settings, click the Basic Auth tab and save the Password.

At the bottom of the page, select Accounts by clicking the expansion arrow to the right of the section. This gives you options you can select from:

  • Choose Company account and all associated merchant accounts to enable for all MIDs.
  • Choose Only selected account groups and merchant accounts to manually select the the MIDs you want to enable for this data connection. If you choose this approach, you will need to update your selections here any time new MIDs are added.

🐘 (Remember, each MID needs to have the required reports enabled.) 🐘

When you're done, click Save changes.

Step 3 - Add a New Data Source to Your Pagos Account

To pull in Adyen data to Pagos, you'll need to add a new data source in your Pagos account:

  1. Log into your Pagos account.
  2. Click your profile icon in the navigation bar, then click Manage Account.
  3. Click the Data Sources tab.
  4. To add a new data source, click + Add Data Source.
  5. In the side panel that opens, click the Provider drop-down, then select Adyen.
  6. Fill in the following fields:
    1. Name - This value is used for display and identification on charts, and can be whatever you prefer
    2. Merchant ID - Enter the ID for the merchant account selected in Step 1
    3. Report Username and Report Password - Enter the Username and Password values saved from Step 2
  7. Add any desired Tags to your data source.
  8. Click the save icon.

Step 4 - Create a Webhook

After you enter your Adyen details in the Data Sources page of your Pagos account and click Add, a pop-up will prompt you to create a webhook. Click Copy beside the destination URL, then click Ok.

Next, log into your Adyen account to create the webhook:

  1. In your Adyen control panel, go now to the company level view by clicking the company name in the top-left corner of the page. This will allow you to configure one webhook for all applicable MIDs at the company level.
  2. Click Developers, then click Webhooks.
  3. Click + Webhook in the top right of the page to create a new webhook. Keep in mind, you don't need to make any changes to your existing webhooks.
  4. Beside Standard notification, click Add.
  5. Click the pencil icon beside Server configuration, then paste the destination URL you copied from your Pagos account into the URL field.
  6. Select the MIDs to connect in your Adyen control panel. You can specify to include 'all' or individual MIDs. These should the same that were configured in step 1. You can find the list of available accounts under Merchant accounts.
  7. Under Additional Settings, click the pencil icon beside each of the following settings to expand these sections, then click the checkbox beside each of the following options:
    1. 3D Secure
      1. Include 3D Secure Result
      2. Include 3D Secure Version
      3. Include 3D Secure2 Challenge Flow Information Details
      4. Include Metadata in payment notification for 3D Secure payments (notifications are not sent from Pal)
      5. Include Raw 3D Secure Details Result
      6. Include Raw 3D Secure Result
    2. Acquirer
      1. Add Acquirer Result
      2. Add Payment Account Reference
      3. Add Raw Acquirer Result
      4. Include Acquirer Error Details
      5. Include Acquirer Reference
      6. Include ARN
      7. Include Custom Routing Flagging
      8. Include the acquirer, acquirer account, raw response and response code of the (retry) attempts
    3. Card
      1. Include Card Bin
      2. Include card info for recurring contract notifications
      3. Include detailed Card BIN Information
      4. Include Extra Costs
      5. Include Funding Source
      6. Include Issuer Country
      7. Include Shopper Country
      8. Include Shopper Details
      9. Include Subvariant
      10. Include the co-brand card information
      11. Return AVS data
    4. Payment
      1. Include Authorized Amount (dynamic zero auth)
      2. Include Shopper Interaction
      3. Include zero auth flag
    5. Risk
      1. Add Capture Reference To Dispute Notification
      2. Include Device Type and Browser Information
      3. Include Dunning Project Data
      4. Include Gross Currency Chargeback Details
      5. Include notes in manual review notifications
      6. Include Risk Data
      7. Include Risk Experiment Reference (notifications are not sent from Pal)
      8. Include Risk Profile (notifications are not sent from Pal)
      9. Include Risk Profile Reference (notifications are not sent from Pal)
      10. Include the originalReference for CHARGEBACK_REVERSED notifications
  8. Click Test configuration to test the webhook, then click Save changes.
  9. Click the toggle next to your new webhook to turn it on.

What’s Next