---
title: "create customer · RUAL Documentation"
description: "Creates the Stripe customer that saved cards, subscriptions and invoices hang off. Stripe enforces no uniqueness : creating this twice for one person gi…"
canonical: https://docs.rual.nl/block-types/stripe/stripeconnection_customers_create
language: en
---

# create customer

This block is part of the [`stripe`](https://docs.rual.nl/block-types/stripe) group and was last modified in core [`v15.0.0`](https://docs.rual.nl/core-versions/150000).

Creates the Stripe customer that saved cards, subscriptions and invoices hang off. Stripe enforces no uniqueness : creating this twice for one person gives them two billing histories and two sets of saved cards, so wire an `idempotency key` from your own user GUID.

- flow `flow`

- connection required `stripeconnection`

- email `value` Where Stripe sends receipts and invoices.

- name `value`

- phone `value`

- description `value` Shown in the Stripe dashboard : a good place for your own user id.

- locale `value` Preferred language for Stripe's emails and hosted pages, e.g. `nl`.

- address `object` `{line1, line2, city, postal_code, state, country}`. Needed for automatic tax.

- shipping `object` `{name, phone, address:{…}}`.

- meta data `object`

- idempotency key `value` Optional. Reusing a key makes Stripe replay the first response instead of creating a second object : wire something stable per order, like the order GUID.

- flow `flow`

- connection `stripeconnection`

- customer id `value` cus_… : store this on your own user record.

- email `value`

- name `value`

- balance `number` Stripe's sign convention is the opposite of the intuitive one: **negative is credit the customer holds**, positive is what they owe.

- currency `value`

- meta data `object`

- customer `object`

- success `condition`

- error `value` Stripe's own message, or a sentinel like MISSING_SESSION_ID for a problem in the wiring.

- error code `value` Stripe's machine-readable code, e.g. `card_declined`, `resource_missing`.

- decline code `value` Why the bank refused, e.g. `insufficient_funds`. Only set on a declined card.

| `stripe customer` |
| --- |
| `billing account` |

### Version history

Introduced in [`v15.0.0`](https://docs.rual.nl/core-versions/150000).

### Service documentation