> ## Documentation Index
> Fetch the complete documentation index at: https://docs.custral.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Stripe

> Sync products, customers, and invoices, and bill from inside Custral.

## What it does

Stripe connects through **Stripe Connect** and brings your billing data into
your workspace as ordinary records, so a Deal can sit next to the invoice it
produced, and a Company can show what it actually pays you.

It's the one integration that also gives you **actions**: workflows and the
assistant can create an invoice, charge a customer, or push a product to Stripe
without leaving Custral.

<Warning>
  These actions move real money. Put a human approval step in front of a charge in
  any workflow that runs unattended, and test against Stripe's test mode first.
</Warning>

## Connect

<Steps>
  <Step title="Authorize with Stripe Connect">
    Go to **Settings → Integrations**, choose **Stripe**, and complete the
    Stripe Connect flow with the account that holds your live data.
  </Step>

  <Step title="Grant read and write">
    Custral requests read-write access. Read to sync products, customers, and
    invoices; write for the invoice and charge actions.
  </Step>

  <Step title="Map the objects">
    Point each of the three mappings at an object in your workspace. Custral can
    create suitable objects if you don't have them yet.
  </Step>
</Steps>

## Configure

Three object mappings decide where Stripe data lands:

| Mapping       | What it holds                                                          |
| ------------- | ---------------------------------------------------------------------- |
| **Products**  | Your Stripe catalogue. One record per product                          |
| **Customers** | Stripe customers, matched to the people and companies you already have |
| **Invoices**  | Issued invoices with their status and amounts                          |

Map Customers onto the object you already use for billable accounts, usually
Companies, rather than a new one, so invoices land beside the rest of the
relationship instead of in a parallel world.

## Resources synced

| Resource        | Custral surface                                     |
| --------------- | --------------------------------------------------- |
| Product         | A record in the mapped Products object              |
| Customer        | A record in the mapped Customers object             |
| Invoice         | A record in the mapped Invoices object              |
| Create Invoice  | A [workflow](/automation/workflows/overview) action |
| Charge Customer | A workflow action                                   |
| Sync Product    | A workflow action                                   |

## Limitations

* Custral surfaces products, customers, and invoices. Subscriptions, disputes,
  payouts, and balance transactions aren't mapped. Read those in Stripe.
* The mappings are **per workspace**, so one Stripe account maps to one set of
  objects. Multiple Stripe accounts in one workspace aren't supported.
* Custral's own [plan and credit billing](/start/custral/billing) is separate
  and unaffected. This integration is about billing *your* customers.

## Troubleshooting

| Symptom                               | Likely cause                                                          | What to check                                                                         |
| ------------------------------------- | --------------------------------------------------------------------- | ------------------------------------------------------------------------------------- |
| Records don't appear after connecting | The object mappings were skipped                                      | Open the integration and set all three mappings                                       |
| Customers arrive as duplicates        | Stripe customers have no email, so nothing matches                    | Add emails in Stripe, or match on a mapped identifier                                 |
| A charge action fails                 | The Connect grant is read-only, or the customer has no payment method | Reconnect accepting read-write; confirm the customer has a saved method in Stripe     |
| Invoice totals look wrong             | Currency differs from the property's configured currency              | Check the [Currency property](/data/properties/number/currency) on the invoice object |

## Disconnect

Disconnect from **Settings → Integrations**. Synced records **stay** in your
workspace as ordinary records, they simply stop updating. Workflow actions that
depend on Stripe start failing, so disable those first.

## See also

* [Workflows](/automation/workflows/overview): automating invoices and charges.
* [Object mapping](/data/properties/complex/object-mapping): how provider data maps to your schema.
* [Billing & Credits](/start/custral/billing): Custral's own billing, which this doesn't touch.


## Related topics

- [Core Concepts](/blocks/concept.md)
- [Quickstart](/dev/webhooks/quickstart.md)
- [Billing & Credits](/start/custral/billing.md)
- [MCP Connections](/ai/mcp-connections.md)
- [TypeScript SDK](/dev/sdks/typescript.md)