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 API Keys page

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

Create a restricted key

In the Restricted keys section of the API keys page, click Create restricted key.
3

Select your integration type

Click Powering an integration you built, then click Continue.
4

Choose a permission template

Click Choose your own.
5

Name your API key

Use the Key name field to name your API key.
6

Set read permissions

Change the permissions for the following resources to Read:
  • Balance
  • Balance Transaction Sources
  • Balance Transfers
  • Charges and Refunds
  • Events
  • Files
  • Payment Disputes
  • Payment Intents
  • Payment Methods
  • Payouts
  • Products
  • Setup Intents
  • Sources
  • Tokens
  • Credit notes
  • Subscriptions
  • Terminal SKUs
  • Financial Reports
7

Set webhook permissions

Change the permissions for Webhook Endpoints, Event Destinations to Write, then click Create key.
8

Copy your key details.

After you create the new restricted key, copy the following details for use in the next step:
  • Name
  • Token

​
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.