Saltar al contenido principal

Créditos

Saldo a favor del cliente, aplicable a facturas futuras. Aplicar y quitar créditos son comandos de la propia factura.

ComandoHTTPDescripción
credits listGET /v1/creditsListar créditos
credits createPOST /v1/creditsAgregar crédito
credits getGET /v1/credits/{id}Obtener crédito
credits updatePATCH /v1/credits/{id}Actualizar crédito
credits deleteDELETE /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​