Crear un customer

post/v1/customers

Entidad de cliente del negocio (no del comprador final regulado); agrupa pagos y métodos.

Request

BASH

curl -X POST https://api.cauril.com/v1/customers \
  -H "Authorization: Bearer sk_test_..." \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "cliente@empresa.com",
    "name": "Acme SA",
    "metadata": {}
  }'

Cuerpo CreateCustomer

email	string · email
name	string
metadata	object

Respuestas

201	Customer creado	Customer
400	Error	Error
401	Error	Error

Ejemplo de respuesta · 201

JSON

{
  "object": "customer",
  "id": "cus_01J...",
  "email": null,
  "name": null,
  "metadata": {},
  "created_at": "2026-06-01T12:00:00Z"
}