Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.pagos.ai/llms.txt

Use this file to discover all available pages before exploring further.

This guide outlines the necessary steps to connect your Pagos and Stripe accounts. There are two ways to connect: 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.
Stripe OAuth is the easiest and recommended way to connect your Stripe and Pagos accounts. This method uses Stripe’s secure authorization flow, so you don’t need to create or manage API keys manually.
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 Processor drop-down menu, then click Stripe.Stripe-Pagos Authorization
6

Name your data connection

Enter a Data Connection Name of your choice; this value is used for display and identification on data visualizations within Pagos Insights.
7

Connect with Stripe.

Click the Stripe OAuth box, then click Connect with Stripe in the bottom-left corner of the side panel. You’ll be redirected to Stripe’s authorization page.
8

Authorize Pagos in Stripe.

Log into your Stripe account (if you’re not already logged in) and authorize Pagos to access your account. Once authorized, you’ll be redirected back to Pagos and the connection will be complete.Stripe-Pagos Authorization

​
API Key Method

You can also connect your Stripe and Pagos accounts using a restricted API key. This method requires you to manually create an API key in the Stripe dashboard and enter it in Pagos.

​
Step 1 – Create a Restricted API Key in Your Stripe Account

For added data security, use a restricted API key to connect your Stripe and Pagos accounts. If you don’t already have one, you’ll need to create one in the Stripe dashboard:
1

Navigate to the Developers page.

Log into your Stripe account, the click Developers to locate your API keys in the Dashboard.
2

Create a restricted key.

Click the API Keys tab, then click Create restricted key.
If you’re using Stripe Workbench, API Keys appears in the pop-up navigation after you click Developers in step 1.
3

Select your integration type.

Click Building your own integration, then click Continue.
4

Name your API key.

Use the Key name field to name your API keys.
5

Set read permissions.

Change the permissions for the following core resources to Read:
  • Balance
  • Balance transaction sources
  • Balance Transfers
  • Charges
  • Disputes
  • Events
  • Files
  • PaymentIntents
  • PaymentMethods
  • Payouts
  • Products
  • SetupIntents
  • Sources
  • Tokens
  • Credit notes
  • Subscriptions
  • SKUs
  • Report Runs and Report Types
6

Set webhook permissions.

Change the permissions for Webhook Endpoints to Write, then click Create key.
7

Copy your key details.

After you create the new restricted key, copy the following details for use in the next step:
  • Name
  • Token (click Reveal test key to access)

​
Step 2: Add a New Data Connection to Your Pagos Account

To pull in Stripe data to Pagos, you’ll need to 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 Processor drop-down, then select Stripe.
6

Name your data connection

Enter a Data Connection Name. This value is used for display and identification on charts, and can be whatever you prefer.
7

Enter your API key

Enter the restricted API key from Step 1 above.
8
Click Add Data Connection.

​
Troubleshooting Tips

  • If you have already configured a webhook for your Stripe account to connect to Pagos, you will receive an error and will need to remove the old webhook so a new one can be generated.
  • After importing your data from Stripe, confirm all BIN number and bank name data appears as expected in your Pagos account. If any data is missing, contact Stripe support and request they enable details on all webhooks.