Integrating Stripe

Capabilities

DataGrail's Stripe integration provides the following capabilities:

Product	Capability
Request Manager	Request Types Access, Deletion Identifier Categories Email
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. Enter DataGrail for the key name.
5. Under Permissions, select the following:

Required Permissions

All core resources:

• Charges: Read
• Disputes: Read
• Customers: Write
• Events: Read
• PaymentIntents: Read
• PaymentMethods: Read
• Sources: Write

All Billing resources:

• Invoices: Read
• Subscriptions: Read

All Orders resources:

• Orders: Read

All Issuing resources:

• Authorizations: Read
• Cardholders: Read
• Cards: Read
• Transactions: Read

Additional Permissions For Responsible Data Discovery

All Connect Resources:

• Read

All Checkout Resources:

• Checkout Sessions: Read

Identity:

• Identity Verification Sessions and Reports: Read

All Payment Links Resources:

• Payment Links: Read

Radar:

• Reviews: Read

Tax:

• Tax Settings and Registrations: Read

6. Select Create Key.
7. Copy the newly created key and store it in a secure, temporary location.

Connect to DataGrail

1. Navigate back to DataGrail.
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.