Skip to main content
POST
/
customers
curl https://api.onepay.la/v1/customers \
  -X POST \
  -H "Authorization: Bearer sk_test_xxx" \
  -H "Content-Type: application/json" \
  -H "x-idempotency: customer-001" \
  -d '{
    "user_type": "natural",
    "first_name": "Juan",
    "last_name": "Pérez",
    "email": "juan@example.com",
    "phone": "+573001234567",
    "document_type": "CC",
    "document_number": "1234567890",
    "enable_notifications": true
  }'

{
  "id":"9da58912-101d-46f8-86c9-20a52119c0bf",
  "first_name":"John",
  "last_name":"Doe",
  "email":"john.doe@example.com",
  "phone":"+573100001020",
  "document_type":"CC",
  "document_number":"1060500333",
  "nationality":"CO",
  "birthdate":"1990-01-01",
  "created_at":"2024-12-04T20:09:08.000000Z"
}

​
Headers

​
x-idempotency
string
required
Token único para garantizar la idempotencia de la petición

​
Body

​
user_type
string
required
Tipo de usuario, valores permitidos: natural, company
​
first_name
string
required
Primer Nombre del cliente
​
last_name
string
required
Apellidos del cliente
​
email
string
required
Correo electrónico del cliente
​
phone
string
required
Número de teléfono del cliente usa el prefijo de la región ejemplo: +57
​
document_type
string
required
Tipo de documento de identidad (CC, CE, NIT, PASSPORT)
​
document_number
string
required
Número de documento de identidad
​
enable_notifications
boolean
default:"true"
required
Habilita notificaciones automáticas por email y SMS al cliente sobre pagos aprobados, rechazados, y links de pago. Valor por defecto: true.
​
nationality
string
Nacionalidad del cliente, Formato ISO 3166-1 alpha-2
​
birthdate
string
Fecha de nacimiento del cliente, formato YYYY-MM-DD
​
related_to
string
Id del cliente al que se relaciona

​
Response

​
id
string
Identificador único del cliente en formato UUID
​
name
string
Nombre del cliente
​
email
string
Correo electrónico del cliente
​
phone
string
Número de teléfono del cliente
​
document_number
string
Número de documento de identidad del cliente
​
document_type
string
Tipo de documento de identidad del cliente (ej. DNI, RUC, CE)
​
created_at
date
Fecha y hora de creación del cliente
{
  "id":"9da58912-101d-46f8-86c9-20a52119c0bf",
  "first_name":"John",
  "last_name":"Doe",
  "email":"john.doe@example.com",
  "phone":"+573100001020",
  "document_type":"CC",
  "document_number":"1060500333",
  "nationality":"CO",
  "birthdate":"1990-01-01",
  "created_at":"2024-12-04T20:09:08.000000Z"
}

curl https://api.onepay.la/v1/customers \
  -X POST \
  -H "Authorization: Bearer sk_test_xxx" \
  -H "Content-Type: application/json" \
  -H "x-idempotency: customer-001" \
  -d '{
    "user_type": "natural",
    "first_name": "Juan",
    "last_name": "Pérez",
    "email": "juan@example.com",
    "phone": "+573001234567",
    "document_type": "CC",
    "document_number": "1234567890",
    "enable_notifications": true
  }'