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

📘

(Optional Step): Collect and Provide Network Token Information

If you provision and collect network tokens through Adyen, you also have the option of receiving additional data on the network tokens you process. If you want to collect this data and subsequently send it to your Pagos accounts, you must follow the steps outlined in Adyen's documentation to collect more information on network tokens.

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.

When you're done, click Save changes.

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

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

1. Log into your Pagos account.
2. Click Data Connections in the main navigation
3. Click Add Data Connection.
4. In the side panel that opens, click the Provider drop-down, then select Adyen.
5. Fill in the following fields:
   1. Data Connection 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
6. Click Add Data Connection.

Step 4 - Create a Webhook

After you enter your Adyen details in the Data Connections page and click Add Data Connection, you'll be prompted to create a webhook. Click the copy icon beside Webhook Destination, then click Complete Webhook Set-Up.

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 the bin and summary information for network tokens in the case of tokenised payments
      4. Include zero auth flag
   5. Risk
      1. Add capture reference to dispute event
      2. Add Visa Rapid Dispute Resolution (RDR) indicator to dispute events
      3. Include Device Type and Browser Information
      4. Include Dunning Project Data
      5. Include Gross Currency Chargeback Details
      6. Include notes in manual review notifications
      7. Include Risk Data
      8. Include Risk Experiment Reference (notifications are not sent from Pal)
      9. Include Risk Profile (notifications are not sent from Pal)
      10. Include Risk Profile Reference (notifications are not sent from Pal)
      11. 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.

Connecting Additional MIDs

After you complete your Adyen data connection, you may decide down the line to connect more Adyen MIDs to your Pagos account. To do so:

1. Log into your Adyen account.
2. Click the company name in the top-left corner of the page, then select the proper merchant account from the drop-down menu.
3. Click Reports in the left-side navigation panel.
4. 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
5. Navigate to the Report User you previously created in Step 2 above and ensure the new MID you're connecting to Pagos is listed under the Accounts section. If not, add it.
6. Navigate to the webhook you previously created in Step 4 above and ensure the new MID you're connecting is listed under the Merchant Accounts section. If not, add it.

📘

Note

You don't need to make any changes to the data connection in your Pagos account.