Create a customer

POST {{baseUrl}}/customers

Create a new Direct Debit customer

ParameterTypeRequiredDescription
firstnamestringtrueYour user's first name.
lastnamestringtrueYour user's last name.
documentTypestringtrueYour user's ID document type. For 🇲🇽 Mexico, this can be one of the following:

- mx_rfc: Tax Identification Number (Registro Federal de Contribuyentes)
- mx_curp: Unique Population Registry Code (Clave Única de Registro de Población)
documentNumberstringtrueThe document number of the user.
emailstringtrueThe email of the user.
phonestringfalseThe phone number of the user (including country code).

You’ll receive the following response from our API, confirming that the customer was created. Make sure to save the customerId you receive, as this ID is required when creating a payment method.

{
  "customerId": "uuid"
}

Request Body

{"firstname"=>"Carlos", "lastname"=>"Azules", "email"=>"carlos.azules@demo.com", "documentType"=>"mx_rfc", "documentNumber"=>"WFB1604128E2"}

HEADERS

KeyDatatypeRequiredDescription
Content-Typestring
Acceptstring

RESPONSES

status: Created

{"customerId":"0d1a377b-b4c5-4a94-9e2e-83e59d1f6a9c"}