Create a customer

Creates a new saved customer resource which you can later manipulate and save payment instruments to.

application/json

Request Body

Details of the customer.

• customer_id string required

  Unique ID of the customer.

• personal_details object

  Personal details for the customer.

  first_name string

  First name of the customer.

  last_name string

  Last name of the customer.

  email string

  Email address of the customer.

  phone string

  Phone number of the customer.

  birthdate date

  Date of birth of the customer.

  address object

  Account's personal address information.

  city string

  City name from the address.

  country string required

  Two letter country code formatted according to ISO3166-1 alpha-2.

  line1 string

  First line of the address with details of the street name and number.

  line2 string

  Second line of the address with details of the building, unit, apartment, and floor numbers.

  postal_code string

  Postal code from the address.

  state string

  State name or abbreviation from the address.

Responses

• 201
• 401
• 403
• 409

---

Created

application/json

• Schema
• Example (from schema)

---

Schema

• customer_id string

  Unique ID of the customer.

• personal_details object

  Personal details for the customer.

  first_name string

  First name of the customer.

  last_name string

  Last name of the customer.

  email string

  Email address of the customer.

  phone string

  Phone number of the customer.

  birthdate date

  Date of birth of the customer.

  address object

  Account's personal address information.

  city string

  City name from the address.

  country string

  Two letter country code formatted according to ISO3166-1 alpha-2.

  line1 string

  First line of the address with details of the street name and number.

  line2 string

  Second line of the address with details of the building, unit, apartment, and floor numbers.

  postal_code string

  Postal code from the address.

  state string

  State name or abbreviation from the address.

{
  "customer_id": "string",
  "personal_details": {
    "first_name": "string",
    "last_name": "string",
    "email": "string",
    "phone": "string",
    "birthdate": "2023-05-24",
    "address": {
      "city": "string",
      "country": "string",
      "line1": "string",
      "line2": "string",
      "postal_code": "string",
      "state": "string"
    }
  }
}

Unauthorized

application/json

• Schema
• Example (from schema)
• Invalid_ Token
• Not_ Authorized_ Token
• Missing_ Token

---

Schema

• message string

  Short description of the error.

• error_code string

  Platform code for the error.

{
  "message": "string",
  "error_code": "string"
}

{
  "error_message": "invalid access token",
  "error_code": "NOT_AUTHORIZED"
}

{
  "error_message": "NOT_AUTHORIZED",
  "error_code": "NOT_AUTHORIZED"
}

{
  "message": "access token required",
  "error_code": "NOT_AUTHORIZED"
}

Forbidden

application/json

• Schema
• Example (from schema)
• Forbidden

---

Schema

• error_message string

  Short description of the error.

• error_code string

  Platform code for the error.

• status_code string

  HTTP status code for the error.

{
  "error_message": "string",
  "error_code": "string",
  "status_code": "string"
}

{
  "error_message": "request_not_allowed",
  "error_code": "FORBIDDEN",
  "status_code": 403
}

Conflict

application/json

• Schema
• Example (from schema)
• Existing_ Customer

---

Schema

• message string

  Short description of the error.

• error_code string

  Platform code for the error.

{
  "message": "string",
  "error_code": "string"
}

{
  "message": "Customer already exists",
  "error_code": "CUSTOMER_ALREADY_EXISTS"
}