Entities

Para cargar deudas en Toku normalmente se crean primero un Customer, luego una Subscription y, si aplica, una Invoice, en llamadas separadas. Si quieres crear las tres entidades de una vez (o solo customer y subscription), puedes usar el endpoint unificado POST /entities.

Una petición a POST /entities crea en orden:

1. Un Customer (obligatorio), con los datos que envíes en customer.
2. Una Subscription (obligatoria), asociada al customer recién creado.
3. Una Invoice (opcional), asociada al customer y a la subscription creados, si envías el objeto invoice en el body.

No hace falta enviar customer ni subscription dentro de invoice ni subscription: el backend usa los IDs de las entidades que acaba de crear. Los IDs en la respuesta vienen encriptados (id_customer, id_subscription, id_invoice) en el mismo formato que en el resto de la API (por ejemplo cus_..., sub_..., inv_...).

Campos mínimos

• Customer: external_id y, si tu organización lo exige, government_id (RUT chileno válido).
• Subscription: product_id.
• Invoice (si se envía): amount y due_date.

Ejemplo de uso

POST /entities con body en JSON que incluya customer, subscription y, opcionalmente, invoice. La respuesta incluye id_customer, id_subscription e id_invoice (este último será null si no se creó invoice).