Skip to main content

Create (or reuse) the organization's Stripe customer

POST 
/stripe/customers

Creates a Stripe Customer for the authenticated user's current organization and persists its id to organization.stripeCustomerId. Idempotent per organization: if the organization already carries a live customer id a 409 is returned, and if a Stripe customer already exists for the given email whose metadata.organization_id matches this organization, that existing customer is re-synced and returned with 200 rather than creating a duplicate. The created customer is tagged with metadata.organization_id and configured for automatic tax (the request IP is used for location validation). Requires the manageBilling ability.

LDS uses only { email, name? } (lib/platform/client.ts createStripeCustomer); the platform additionally accepts phone, address, and taxIds.

Request​

Responses​

An existing matching customer was found and re-synced to the organization.