Integrating Stripe

Capabilities

DataGrail's Stripe integration provides the following capabilities:

Product	Capability
Request Manager	Request Types Access, Deletion Identifier Categories Email, Service ID
Live Data Map	Data Discovery

Before You Start

To successfully configure this integration, please ensure you have sufficient privileges:

• DataGrail User Role: Super Admin, Connections Manager
• Stripe User Role: Admin

Create Stripe API Key

1. Navigate to your Stripe Dashboard.

2. In the top right, select Developers.

3. Select API Keys and then Create restricted key.

4. When prompted with How will you be using this key?, select Powering an integration you built.

5. When prompted with Choose a permission template, select Choose your own.

6. Enter DataGrail for the key name.

7. Set the permissions listed below. The Create restricted key page lists each resource under a Resource Type column with two sets of toggles: Permissions and Connect Permissions. Set the values in the Permissions column only, and leave every Connect Permissions row set to None.

   Finding Resources

   Stripe groups and labels resources on this page. If you can't find a resource by name, use your browser's find (Ctrl+F / Cmd+F) to locate it, and check the group headings (such as Billing, Issuing, or Connect).

   Required Permissions

   Set each of the following to the listed value in the Permissions column:

   Resource Type	Permission
   Charges and Refunds	Read
   Payment Disputes	Read
   Customers	Write
   Events	Read
   Payment Intents	Read
   Payment Methods	Read
   Sources	Write
   Invoices	Read
   Subscriptions	Read
   Orders	Read
   Issuing Authorizations	Read
   Issuing Cardholders	Read
   Issuing Cards	Read
   Issuing Transactions	Read

   Additional Permissions For Responsible Data Discovery

   These permissions enable additional Responsible Data Discovery coverage. Set each to the listed value in the Permissions column:

   Resource Type	Permission
   Accounts	Read
   Checkout Sessions	Read
   Identity Verification Results	Read
   Money Management Financial Accounts	Read
   Payment Links	Read
   Payouts	Read
   Reviews	Read
   Setup Intents	Read
   Tax Settings, Registrations	Read

8. Select Create Key.

9. When prompted with Verification required, complete the verification steps.

10. Once verified, Stripe displays the new API key — copy it and store it in a secure, temporary location.

Connect to DataGrail

1. In DataGrail, navigate to Integrations and select Configure New Integration to search for Stripe.
2. Enter the API Key.
3. Select Configure Integration.

Next Steps

Now that you've successfully connected the integration, check out the following resources:

• Access Request Lifecycle
• Deletion Request Lifecycle
• Request Manager Overview
• Customizing Intake Forms

Troubleshooting

If you are unable to successfully connect the integration, review these common troubleshooting steps:

Ensure Required Permissions Are Granted on API Keys/Resources

DataGrail checks required permissions and scopes on API keys/resources used by each integration. If all necessary permissions are not granted, new connections will fail.

Review Required Account Types and User Roles

If users do not have the necessary permissions or the minimum required user role in the connecting system, the connection to DataGrail will fail. Additionally, connections will fail if your account type does not match the one required by the integration.

See Before You Start to review these requirements.

Technical Details

The Stripe integration uses the Stripe V1 API:

Access Type	Synchronous
Deletion Type	Synchronous

API Documentation

Learn more about this API implementation and DataGrail functionality in our API Integration Documentation.