Create Customer

POST 
/customers

Creates a customer.

Every field is optional — a customer with no details at all is valid, and useful if you only want somewhere to attach saved payment methods.

Pass the returned id as customerId when you create a payment or a subscription to link it to this buyer.

What linking does:

• A payment saved with generatePaymentToken stores its payment method under this customer
• The customer's details are copied onto the payment at the time it is made. Editing the customer later never rewrites a payment that already happened
• A subscription gains renewal failover across the customer's other saved payment methods

Best practices:

• Create the customer once, when the buyer first registers with you, and reuse the id
• Use metadata to store your own user identifier, so you can match your records to MONEI's

Request

Responses

200

A customer object

400

The request is incorrect or could not be processed

401

Unauthorized error. Please check your auth credentials

404

The specified resource was not found

422

The request was well-formed but could not be processed due to semantic errors

500

Unexpected server error

503

The service is temporarily unavailable