Skip to main content
This guide outlines the necessary steps to connect your Pagos and Checkout.com accounts. For more information on connecting Pagos to other payment processors, see our Connecting Your Payment Processors to Pagos guide.
Sensitive Data Warning:Never include sensitive customer data in the metadata fields passed to Pagos.

​
Step 1 – Retrieve Your Client ID and Create a Secret API Key

​
Retrieve Your Client ID

Your Checkout.com Client ID is required when adding the data connection in Pagos. To find it:
  1. Sign in to the Checkout.com Dashboard.
  2. Click the Settings icon in the top-right corner.
  3. Click Account details.
  4. Under Unique identifiers, copy your Client ID.
You will need this value for Step 3.
You must have the Account owner or Admin user role in Checkout.com to view the Client ID. If you can’t find it, contact your Checkout.com account manager or request support.

​
Create a Secret API Key

For added data security, use a secret API key to connect your Checkout.com and Pagos accounts. If you don’t already have one, you’ll need to create one in the Checkout.com dashboard. Log into your Checkout.com account, then follow the process outlined in Checkout.com’s documentation to locate your API keys. While following the instructions in this guide, keep in mind the following:
  • When selecting an API key, select Secret API key and add a description that identifies the key as a Pagos key
  • Under Scope, navigate from Default to Customize and select the following checkboxes:
    • balances:view
    • disputes:view
    • files
    • financial-actions:view
    • flow:events
    • flow:workflows
    • gateway
    • payments:search
    • reports
    • reports:view
    • risk
  • You’ll be asked to pick Entities and Processing Channels; select the entities and processing channels you want to include in your connection
After you create the new Secret key, copy the key for use in the next step.

​
Step 2 - Configure Reports in Your Checkout.com Account

From your Checkout.com account, you’ll need to configure each of the following report types: To do so, follow these steps for each report type:
1
Click Reports in the left navigation.checkout1
2
In the Reports section, click the Schedules tab, then click Create Schedule.checkout2
3
Under Delivery type, select Dashboard as the report source.checkout3
4
Use the Report type dropdown to select the report (e.g. Financial Actions).
5
Configure the following settings:
  • Time Zone: UTC
  • Frequency: Daily.
  • Schedule name: Rename it to match the report type (e.g. DailyFinancialActions-Pagos) checkout4
6
Under Customize included fields, click Select all, then deselect any fields that contain PII, such as:
  • Billing address
  • Shipping address
  • Cardholder name
  • Email
7
Click Create.

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

To pull in Checkout.com data to Pagos, add a new data connection in your Pagos account:
1
Log into your Pagos account.
2
Click the settings icon in the top-right corner of the page.
3
Under Data Connections, click Connections.
4
Click Add Data Connection.
5
In the side panel that opens, click the Provider drop-down, then select Checkout.com.
6
Enter a Data Connection Name. This value is used for display and identification on charts, and can be whatever you prefer.
7
Enter the Client ID from Step 1.
8
Enter the Secret Key from Step 1.
9
Click Add Data Connection.

​
Step 4 - Create a Webhook

After you enter your Checkout.com 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 Checkout.com account to create the webhook:
1
In your Checkout.com dashboard, click Developers in the left navigation, then click Webhooks.
2
Click Create configuration.
3
Enter a Name for the webhook (e.g. “Pagos”).
4
Paste the destination URL you copied from your Pagos account into the Endpoint URL field.
5
Under Events, select all events within each of the following categories:
  • Disputes
  • Fraud
  • Gateway
  • Reports
6
Under Entities and processing channels, select the entities and processing channels to include. These should be the same ones selected in Step 1.
7
Click Create webhook.