Stripe App

If you don’t already have one, sign up for a Stripe account.

1. If you haven’t already, install the Stripe CLI.
2. Log in using your Stripe account:
   Copy

   Ask AI

   stripe login
   

1. Run the following command to install the Stripe Apps plugin:
   Copy

   Ask AI

   stripe plugin install apps
   

2. Verify the plugin version is 1.5.12 or newer:
   Copy

   Ask AI

   stripe apps -v
   

1. Create a new app project using the CLI:
   Copy

   Ask AI

   stripe apps create my-stripe-app
   

2. This creates a local project folder with a manifest and app code.

Open the stripe-app.json file and update these fields:

• stripe_api_access_type: Set to oauth
• distribution_type: Set to public
• allowed_redirect_uris: Add your redirect URI as https://api.nango.dev/oauth/callback. Example:

{
  "id": "com.example.my-app",
  "version": "0.0.1",
  "name": "My Stripe App",
  "icon": "./icon.png",
  "permissions": [],
  "stripe_api_access_type": "oauth",
  "distribution_type": "public",
  "allowed_redirect_uris": [
    "https://api.nango.dev/oauth/callback"
  ]
}

1. Add permissions your app requires to access Stripe resources in the manifest (e.g., read_only, customers:read, etc.).

"permissions": [
    {
        "permission": "customer_read",
        "purpose": "Receive access to the customer’s phone number"
    }
]

2. Optionally add a settings view or other UI extensions if your app has a user-facing configuration.

1. Ensure you’re logged into a fully activated (non-sandbox) Stripe account.
2. Upload your app to Stripe:
   Copy

   Ask AI

   stripe apps upload
   

• Submit your app for review when you’re ready to publish it to the Stripe App Marketplace.
• When submitting an OAuth app, you must provide a Marketplace install URL. This URL should point to a page that initiates onboarding and installation, and clearly uses the OAuth install links found in the Settings tab of your app.
  The public OAuth install links from the Settings tab are different from those in the External test tab and must be used for review and production installs. Even though these links are inactive until the app is published, the Stripe App Review team can still use them to install and test your app.

1. Go to your app’s Settings tab in the Stripe Dashboard.
2. Locate the Live mode link under the Install link section. The Client ID is included as a query parameter in either the Live mode or Test mode link (e.g., client_id=…). Use the link for whichever mode you’d like to test or deploy.
3. To obtain your Client Secret, go to the API Keys page in the Stripe Dashboard and copy your Secret key (starts with sk_live_…). Save these credentials securely as you’ll need them when configuring your integration in Nango.

Follow the Quickstart.