Créditos
Saldo a favor del cliente, aplicable a facturas futuras. Aplicar y quitar créditos son comandos de la propia factura.
| Comando | HTTP | Descripción |
|---|---|---|
credits list | GET /v1/credits | Listar créditos |
credits create | POST /v1/credits | Agregar crédito |
credits get | GET /v1/credits/{id} | Obtener crédito |
credits update | PATCH /v1/credits/{id} | Actualizar crédito |
credits delete | DELETE /v1/credits/{id} | Eliminar crédito |
Ejemplos
--params lleva parámetros de query y de ruta (id, página, filtros); --json lleva el cuerpo de la solicitud; --fields limita los campos que vuelven — vale la pena en todo list/get, para ahorrar contexto. Mira Flags globales para la referencia completa.
# Listar créditos
kobana billing credits list \
--fields "id,public_id,external_id,billing_account_id,organization_id"
# Obtener crédito
kobana billing credits get --params '{"id": "CREDIT_ID"}'
# Agregar crédito
kobana billing credits create \
--json '{"billing_account_id": "BILLING_ACCOUNT_ID", "type": "promotional", "amount_cents": 10000}'
# Actualizar crédito
kobana billing credits update \
--params '{"id": "CREDIT_ID"}' \
--json '{"external_id": "EXTERNAL_ID", "type": "promotional", "amount_cents": 100}'
# Eliminar crédito
kobana billing credits delete --params '{"id": "CREDIT_ID"}' --dry-run
Próximos pasos
- Retenciones
- Introspección de schema — todos los parámetros que este recurso acepta.