Skip to main content

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"
}
Last updated on