Stripe Setup Guide

Prerequisites

You need access to an active Stripe account with permission to create API keys.

Setup Guide

Step 1: Create a restricted API key in Stripe

Matia requires a restricted API key (not a secret key) so you can grant only the permissions it needs.

1. Log in to your Stripe Dashboard.

2. In the left sidebar, go to Developers → API keys.

3. Click Create restricted key.

4. Give the key a name (e.g. "Matia Sync").

5. Set permissions for the scopes listed below. For each scope, set Permissions to Read and Connect Permissions to Read:

   • Core
   • Access Management
   • Accounts v2
   • Batches
   • Billing
   • Checkout Sessions
   • Claimable Sandboxes
   • Climate
   • Commerce
   • Connect
   • Financial Connections
   • Identity
   • Issuing
   • Money Management
   • Orchestrated Commerce
   • Orders
   • Payment Links
   • Payment Records
   • Provisioning
   • Radar
   • Reporting
   • Sigma
   • Stripe Apps
   • Stripe Network
   • Tax
   • Terminal
   • Third-Party Gift Cards
   • Webhook Endpoints
   • Workflows

   Note: Any top-level scope that only offers None and Write (no Read option) can be left as None.

6. Click Create key and copy the generated key. You will not be able to view it again after leaving the page.

Step 2: Complete Configuration in Matia

1. Enter the restricted key from step 1 in the Access Token field.
2. (Optional) Set a value between 30 and 90 for Rate Limit Requests. This controls how aggressively Matia calls the Stripe API — lower values reduce the risk of hitting Stripe’s rate limits.
3. Enter a Name for the connector.
4. (Optional) Enter a Description for the connector.
5. Select the Owner of the connector.
6. (Optional) Click Test Connection to verify the key works before saving.
7. Click Connect.