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 Connect to Braintree and Connect to Stripe guides.

Step 1 - Configure Reports in Your Adyen Account

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 user.
  2. Click Reports in the left-side navigation panel.
  3. For each of the following reports, click Automatic generation, then click the Automatic generation toggle and select CSV for the file format:
    1. Aggregate settlement details
    2. Dispute transaction details
    3. Received payment details
    4. Settlement details

Step 2 - Create a Report User in Your Adyen Account

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.

When you're done, click Save.

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 the settings icon in the navigation bar, then click Data Sources.
  3. To add a new data source, click + Add new data source.
  4. In the right-side panel that opens, click Adyen, then 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
  5. Click Add.

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, click the company name in the top-left corner of the page, then select the proper merchant account from the drop-down menu. This should be the same merchant account from Step 1.
  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. 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
    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
  7. Click Test configuration to test the webhook, then click Save changes.
  8. Click the toggle next to your new webhook to turn it on.

What’s Next
Did this page help you?