---
title: "Stripe Apps Integration Guide | Tajo"
description: "Status: planned, not built. This section is a build guide. Tajo has no Stripe App, and nothing here can be installed today."
url: https://tajo.io/docs/stripe-apps/
markdown: https://tajo.io/docs/stripe-apps.md
lang: en-US
author: "Set Noa"
author_url: https://tajo.io/set-noa/
---

# Stripe Apps Integration Guide

[Set Noa](https://tajo.io/set-noa/)

Stripe Apps let you embed custom functionality directly into the Stripe Dashboard. This section is a **build guide**: it documents how such an app for the Tajo–Brevo integration would be built, tested, and published.

Caution

**Status: planned, not built.** Tajo has no Stripe App, so nothing in this section can be installed today, and the app identifiers, URLs, and credentials in these pages are illustrative placeholders, not live endpoints. To connect Stripe to Tajo right now, use the [Stripe connector](https://tajo.io/docs/connectors/stripe/) (restricted API key, read-only sync).

Tip

The goal is to publish a **Brevo integration** on the Stripe App Marketplace, enabling Stripe merchants to sync customer data, orders, and events directly into Brevo for marketing automation and CRM.

## What Are Stripe Apps?

Stripe Apps extend the Stripe Dashboard with custom UI components and backend integrations. They allow third-party developers to:

- Add custom views to Stripe Dashboard pages (customers, payments, invoices, etc.)
- Access Stripe data through scoped permissions
- Sync data between Stripe and external platforms like Brevo
- Provide onboarding and configuration flows within the Dashboard

## Tajo + Brevo Integration Goals

The Tajo Stripe App connects Stripe with Brevo to deliver:

- **Customer Intelligence**: Sync Stripe customer profiles, payment history, and lifetime value into Brevo contacts
- **Event Tracking**: Push Stripe events (payments, subscriptions, refunds) as Brevo transactional events
- **Automated Campaigns**: Trigger Brevo email, SMS, and WhatsApp campaigns based on Stripe activity
- **Loyalty Programs**: Build retention workflows using Stripe purchase data synced to Brevo

## Architecture Overview

*Where a Stripe app's data goes. The Stripe dashboard and Tajo exchange customer and payment data, and Tajo syncs contacts, campaigns and automations with Brevo.*

## Guide Contents

This documentation covers the complete lifecycle of building and publishing a Stripe App:

### Getting Started

| Guide | Description |
| --- | --- |
| [Publishing to Marketplace](https://tajo.io/docs/stripe-apps/publish-app) | Requirements and steps to submit your app for review |
| [App Review Requirements](https://tajo.io/docs/stripe-apps/review-requirements) | Quality, security, and UX standards for approval |

### Configuration & Reference

| Guide | Description |
| --- | --- |
| [App Manifest Reference](https://tajo.io/docs/stripe-apps/app-manifest) | Complete schema for the `stripe-app.json` manifest file |
| [Permissions Reference](https://tajo.io/docs/stripe-apps/permissions) | Full list of Stripe API permissions and how to request them |
| [Viewports Reference](https://tajo.io/docs/stripe-apps/viewports) | Dashboard locations where your app UI can appear |

### Features & Integration

| Guide | Description |
| --- | --- |
| [Embedded Stripe Apps](https://tajo.io/docs/stripe-apps/embedded-apps) | Using Connect embedded components for platform integrations |
| [Install Links & Deep Links](https://tajo.io/docs/stripe-apps/install-links) | Generate install URLs and deep link into specific app views |
| [Post-Install Actions](https://tajo.io/docs/stripe-apps/post-install) | Configure onboarding flows after app installation |

### Operations & Growth

| Guide | Description |
| --- | --- |
| [App Analytics](https://tajo.io/docs/stripe-apps/analytics) | Track installs, views, and conversion metrics |

## Prerequisites

Before building a Stripe App, ensure you have:

1. **Stripe Account**: An activated Stripe account (not restricted to test mode)
2. **Stripe CLI**: Install the Stripe CLI for local development and app uploads
3. **Node.js**: Version 16 or later for the app UI extension
4. **Tajo Platform Access**: Active Tajo account with Brevo API credentials configured

## Quick Start

```bash
# Install Stripe CLI
brew install stripe/stripe-cli/stripe

# Login to your Stripe account
stripe login

# Create a new Stripe App project
stripe apps create tajo-brevo-integration

# Start local development
stripe apps start
```

## Key Concepts

### App Manifest

Every Stripe App has a `stripe-app.json` manifest that declares permissions, viewports, and configuration. See the [App Manifest Reference](https://tajo.io/docs/stripe-apps/app-manifest) for the full schema.

### UI Extensions

Stripe Apps can render React-based UI components in specific Dashboard viewports. The UI toolkit provides pre-built components that match the Stripe Dashboard design system.

### Permissions

Apps must declare the specific Stripe API resources they need access to. Users approve these permissions during installation. See the [Permissions Reference](https://tajo.io/docs/stripe-apps/permissions).

### Signing Secret

Each app receives a signing secret for verifying install signatures and securing communication between your backend and Stripe.

## Development Workflow

1. **Define** your manifest with required permissions and viewports
2. **Build** the UI extension using Stripe’s React component library
3. **Implement** backend endpoints for data sync with Brevo via Tajo
4. **Test** locally using `stripe apps start`
5. **Upload** with `stripe apps upload`
6. **Submit** for review through the Stripe Dashboard
7. **Publish** and monitor via analytics

Caution

Stripe requires apps to be written in English for marketplace distribution. Your app listing, UI text, and documentation must all be in English.

## Next Steps

Start with the [Publishing Guide](https://tajo.io/docs/stripe-apps/publish-app) to understand the full requirements, then work through the technical references to configure your app manifest and permissions.