Customer

idstring<uuid>required

Unique identifier for the customer.

Example: a4e1d1dd-e0c2-4f7a-a2b1-2b0f1f9b6b1e

emailCustomer-Email

The customer's email address.

Example: john.doe@example.com

nameCustomer-Name

The customer's full name or business name.

Example: John Doe

phoneCustomer-Phone

The customer's phone number in E.164 format.

Example: +34666666666

billingDetails object

Billing information associated with the payment method at the time of the transaction.

namestring

The customer's billing full name.

Example: John Doe

emailstring

The customer's billing email address.

Example: john.doe@example.com

phonestring

The customer's billing phone number in E.164 format.

Example: null

companystring

Billing company name.

Example: null

taxIdstring

Company tax ID.

Example: null

address object

countryCountry

Two-letter country code (ISO 3166-1 alpha-2).

Example: ES

citystring

City, district, suburb, town, or village.

Example: Málaga

line1string

Address line 1 (e.g., street, PO Box, or company name).

Example: Fake Street 123

line2string

Address line 2 (e.g., apartment, suite, unit, or building).

Example: null

zipstring

ZIP or postal code.

Example: 1234

statestring

State, county, province, or region.

Example: Málaga

shippingDetails object

Shipping information associated with the payment.

namestring

The shipping customer's full name.

Example: John Doe

emailstring

The shipping customer's email address.

Example: john.doe@example.com

phonestring

The shipping customer's phone number in E.164 format.

Example: null

companystring

Name of the company where the shipment is going.

Example: null

taxIdstring

Company tax ID.

Example: null

address object

countryCountry

Two-letter country code (ISO 3166-1 alpha-2).

Example: ES

citystring

City, district, suburb, town, or village.

Example: Málaga

line1string

Address line 1 (e.g., street, PO Box, or company name).

Example: Fake Street 123

line2string

Address line 2 (e.g., apartment, suite, unit, or building).

Example: null

zipstring

ZIP or postal code.

Example: 1234

statestring

State, county, province, or region.

Example: Málaga

metadataobject

A set of key-value pairs that you can attach to a resource. This can be useful for storing additional information about the resource in a structured format.

Example: {"systemId":"12345"}

defaultTokenIdCustomer-DefaultTokenId

The payment method charged when a payment sets useDefaultPaymentMethod.

MONEI fills this only while it is empty: the first reusable payment method the customer saves becomes the default, and a value you set here is kept. Deleting that payment method clears the field, so the next reusable one the customer saves becomes the new default. It must be the ID of a payment method this customer already owns, and one that can be reused for future payments.

Example: 7cc38b08ff471ccd313ad62b23b9f362b107560b

createdAtstring<date-time>

Time at which the resource was created.

Example: 2026-09-21T10:25:52.000Z

updatedAtstring<date-time>

Time at which the resource was last updated.

Example: 2026-09-21T10:25:52.000Z

Customer

{
  "id": "a4e1d1dd-e0c2-4f7a-a2b1-2b0f1f9b6b1e",
  "email": "john.doe@example.com",
  "name": "John Doe",
  "phone": "+34666666666",
  "billingDetails": {
    "name": "John Doe",
    "email": "john.doe@example.com",
    "phone": null,
    "company": null,
    "taxId": null,
    "address": {
      "country": "ES",
      "city": "Málaga",
      "line1": "Fake Street 123",
      "line2": null,
      "zip": "1234",
      "state": "Málaga"
    }
  },
  "shippingDetails": {
    "name": "John Doe",
    "email": "john.doe@example.com",
    "phone": null,
    "company": null,
    "taxId": null,
    "address": {
      "country": "ES",
      "city": "Málaga",
      "line1": "Fake Street 123",
      "line2": null,
      "zip": "1234",
      "state": "Málaga"
    }
  },
  "metadata": {
    "systemId": "12345"
  },
  "defaultTokenId": "7cc38b08ff471ccd313ad62b23b9f362b107560b",
  "createdAt": "2026-09-21T10:25:52.000Z",
  "updatedAt": "2026-09-21T10:25:52.000Z"
}