create customer
This block is part of the stripe group and was last modified in core v15.0.0.
create customer v15.0.0 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
valueWhere Stripe sends receipts and invoices.
- name
value - phone
value - description
valueShown in the Stripe dashboard : a good place for your own user id.
- locale
valuePreferred 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
valueOptional. 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
valuecus_… : store this on your own user record.
- email
value - name
value - balance
numberStripe'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
valueStripe's own message, or a sentinel like MISSING_SESSION_ID for a problem in the wiring.
- error code
valueStripe's machine-readable code, e.g.
card_declined,resource_missing. - decline code
valueWhy the bank refused, e.g.
insufficient_funds. Only set on a declined card.
stripe customer |
billing account |
Version history
Introduced in v15.0.0.
Service documentation
External API reference This block wraps a third-party service. Click here for the service's own documentation of the underlying endpoint.Back to
stripe Return to the main group to view all sub-groups Back to customers Return to the group to view all blocks within this group