Cuentas de cobro

La cuenta que acumula suscripciones, facturas y créditos de un cliente. Suspender interrumpe el cobro sin terminar la relación; cerrar la termina.

Comando	HTTP	Descripción
billing-accounts list	GET /v1/billing_accounts	Listar cuentas de cobro
billing-accounts create	POST /v1/billing_accounts	Crear cuenta de cobro
billing-accounts get	GET /v1/billing_accounts/{id}	Obtener cuenta de cobro
billing-accounts update	PATCH /v1/billing_accounts/{id}	Actualizar cuenta de cobro
billing-accounts delete	DELETE /v1/billing_accounts/{id}	Cerrar cuenta de cobro
billing-accounts close	POST /v1/billing_accounts/{id}/close	Cerrar cuenta de cobro (POST /close)
billing-accounts credits	GET /v1/billing_accounts/{id}/credits	Listar los créditos de la cuenta
billing-accounts entitlements	GET /v1/billing_accounts/{id}/entitlements	Listar los productos contratados de la cuenta
billing-accounts invoices	GET /v1/billing_accounts/{id}/invoices	Listar las facturas de la cuenta
billing-accounts reactivate	POST /v1/billing_accounts/{id}/reactivate	Reactivar cuenta de cobro
billing-accounts subscriptions	GET /v1/billing_accounts/{id}/subscriptions	Listar las suscripciones de la cuenta
billing-accounts suspend	POST /v1/billing_accounts/{id}/suspend	Suspender cuenta de cobro

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 cuentas de cobro
kobana billing billing-accounts list \
  --fields "id,public_id,external_id,currency,billing_email"

# Obtener cuenta de cobro
kobana billing billing-accounts get --params '{"id": "BILLING_ACCOUNT_ID"}'

# Crear cuenta de cobro
kobana billing billing-accounts create --json '{"customer": "CUSTOMER"}'

# Actualizar cuenta de cobro
kobana billing billing-accounts update \
  --params '{"id": "BILLING_ACCOUNT_ID"}' \
  --json '{"external_id": "EXTERNAL_ID", "name": "NAME", "email": "EMAIL"}'

# Cerrar cuenta de cobro (POST /close)
kobana billing billing-accounts close \
  --params '{"id": "BILLING_ACCOUNT_ID"}' \
  --json '{"reason": "REASON"}'

# Cerrar cuenta de cobro
kobana billing billing-accounts delete \
  --params '{"id": "BILLING_ACCOUNT_ID"}' \
  --dry-run

Próximos pasos

• Facturas
• Introspección de schema — todos los parámetros que este recurso acepta.