Criar cliente

Cadastra quem paga você, para ligar cobranças a ele.

POST /v1/customers

cURL

curl -X POST https://bukio-backend-production.up.railway.app/v1/customers \
  -H "Authorization: Bearer bk_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "name": "Ana Souza", "email": "[e-mail]", "phone": "11999998888", "document": "123.456.789-09" }'

200

{
  "id": "0d6c1a7e-5b7f-4f3e-9b2a-1c2d3e4f5a6b",
  "name": "Ana Souza",
  "email": "[e-mail]",
  "phone": "11999998888",
  "document": "12345678909",
  "createdAt": "2026-10-08T15:00:00.000Z"
}

Escopo customers:write. E-mail, celular e documento ficam criptografados na WyzeCash.

name · string · required

2 a 120 caracteres (INVALID_NAME).

email · string | null

E-mail válido (INVALID_EMAIL).

phone · string | null

Celular com DDD, com ou sem +55, formatado ou só dígitos (INVALID_PHONE).

document · string | null

CPF ou CNPJ válido, com ou sem pontuação (INVALID_DOCUMENT).

​

Resposta

id · string

UUID do cliente. Use em customerId ao criar cobranças.

name · string

Nome.

email · string | null

E-mail.

phone · string | null

Celular, só dígitos.

document · string | null

CPF ou CNPJ, só dígitos.

createdAt · string

Criação.

cURL

curl -X POST https://bukio-backend-production.up.railway.app/v1/customers \
  -H "Authorization: Bearer bk_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "name": "Ana Souza", "email": "[e-mail]", "phone": "11999998888", "document": "123.456.789-09" }'

200

{
  "id": "0d6c1a7e-5b7f-4f3e-9b2a-1c2d3e4f5a6b",
  "name": "Ana Souza",
  "email": "[e-mail]",
  "phone": "11999998888",
  "document": "12345678909",
  "createdAt": "2026-10-08T15:00:00.000Z"
}