Stripe, Inc. is an Irish-American multinational financial services and software as a service (SaaS) company that primarily offers payment-processing software and APIs for e-commerce websites and mobile applications.
In the new app
- Store API/SFTP secrets under Import › Setup › Credentials (use Create Credential).
- Attach the credential to a PSP Source under Import › Setup › Sources.
- Monitor ingestion under Import › Files.
The Actuals connector to Stripe enables daily import of all Stripe transactions for reconciliation in the Actuals platform. To achieve this, an API key needs to be created to download the transaction details through the Stripe API. The steps below illustrate how to get the API key and how to configure Actuals to collect the data periodically.
Setup the API integration
Prerequisites
- Access to your Stripe account with rights to maintain API keys and grant access rights to these keys.
Creating the API key and maintaining settings
- Sign in to your Stripe dashboard
- Go to Stripe Dashboard → Developers → API Keys.
- Ensure you are in live mode. At the top-right, check the “Viewing test data” toggle. If it’s enabled, disable it to switch to live mode. ⚠️ Important: Test keys only return test data and cannot be used for live data collection.
- Click “Create Restricted Key”.
- When prompted:
- Select “Providing this key to another website” and continue.
- Enter the following:
- Name:
Actuals.io - Website:
https://actuals.io - Select “Customize permissions for this key” before continuing.
- Set permissions. Grant read-only access to the following resource types. Make sure to select Read at the resource type level to automatically include all underlying resources.
Resource type | Permissions |
Core | Read |
Billing | Read |
Connect | Read |
Orders | Read |
Reporting | Read |
Sigma | Read |
All webhook | Read |
- Finalize and copy the key. Click “Create key” once all permissions are correctly set. Click the token to copy it to your clipboard.
You’ve now successfully created a Restricted API Key. Use the next section of the guide to add this credential to Actuals.
Adding a credential to Actuals
To add a credential to Actuals:
- Sign in to Actuals and navigate to Import › Setup › Credentials.
- Click Create Credential.
- Provide a desired name for the credential.
As a best practice we suggest to use the combination of the application name and the account the credential is part of. For example “Adyen - European Merchant”.
- Provide the desired credential type.
- Dependent on the type you will be asked to provide one or more credential parameters.
- Click Create to add the credential.
You now successfully created the credential. Please inform your Actuals implementation consultant once you successfully added the credential in Actuals.