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

# Stripe

> Monk integration with Stripe payments and billing

# Stripe

Monk connects to Stripe through [Stripe Connect](https://stripe.com/connect) and
listens to Stripe events in real time. This keeps invoice status, payments,
credit notes, and refunds aligned between the two systems.

## Supported entities

| Monk entity       | Stripe entity           |
| ----------------- | ----------------------- |
| Customer          | Customer                |
| Invoice           | Invoice                 |
| Invoice line      | Invoice line item       |
| Payment           | Payment intent / charge |
| Credit memo       | Credit note             |
| Refund            | Refund                  |
| Product / price   | Product / price         |
| Connected account | Connected account       |

## Authentication

* Monk uses Stripe Connect OAuth to authorize access to your Stripe account.
* Stripe API keys and webhook signing secrets are encrypted at rest.
* You can disconnect Monk from your Stripe dashboard at any time.

## Multi-entity, currency, and parent-child

* **Connected accounts:** If you use Stripe Connect, each connected account can
  map to a separate Monk org so payments and invoices stay in the right legal
  entity.
* **Currency:** Stripe transactions carry their original currency. Monk stores
  invoice and payment amounts in the transaction currency and records exchange
  rates when Stripe provides them.
* **Customers:** Stripe supports grouped customers through metadata; Monk
  preserves the customer identity and any grouping values sent from Stripe.

## Configuration options

* **Connected account mapping:** choose which Stripe account each Monk org
  connects to.
* **Customer sync scoping:** sync all customers, only a named allowlist, or
  exclude specific Stripe customer IDs.
* **Invoice filtering:** control which Monk invoices create Stripe invoices (for
  example, exclude zero-total or draft invoices).
* **Auto-payment collection:** honor Stripe auto-pay settings and saved payment
  methods.
* **Webhook event selection:** Monk listens to the events needed to keep payment
  and credit-note state current.
* **Refund behavior:** credit notes in Stripe backfill as Monk credit memos.

## Sync and reliability

* Real-time event processing via Stripe webhooks.
* Idempotency on invoice creation to avoid duplicates.
* Automatic retry and dead-letter handling for transient webhook failures.
* Periodic reconciliation to catch any events missed between webhook deliveries.

## Frequently asked questions

**Can Monk create Stripe invoices?**
Yes. Monk can generate Stripe invoices for receivables managed in Monk and
update their status as payment events arrive.

**Does Monk handle Stripe subscriptions?**
Monk focuses on invoice, payment, credit note, and customer sync. Subscription
lifecycle management remains in Stripe.

**What if a Stripe refund happens?**
Stripe `charge.refunded` events create or update refund records in Monk and
backfill credit memos when Stripe credit notes are issued.