Contas de cobrança

A conta que acumula assinaturas, faturas e créditos de um cliente. Suspender interrompe a cobrança sem encerrar o relacionamento; fechar encerra.

Comando	HTTP	Descrição
billing-accounts list	GET /v1/billing_accounts	Listar contas de cobrança
billing-accounts create	POST /v1/billing_accounts	Criar conta de cobrança
billing-accounts get	GET /v1/billing_accounts/{id}	Obter conta de cobrança
billing-accounts update	PATCH /v1/billing_accounts/{id}	Atualizar conta de cobrança
billing-accounts delete	DELETE /v1/billing_accounts/{id}	Fechar conta de cobrança
billing-accounts close	POST /v1/billing_accounts/{id}/close	Fechar conta de cobrança (POST /close)
billing-accounts credits	GET /v1/billing_accounts/{id}/credits	Listar créditos da conta
billing-accounts entitlements	GET /v1/billing_accounts/{id}/entitlements	Listar produtos contratados da conta
billing-accounts invoices	GET /v1/billing_accounts/{id}/invoices	Listar faturas da conta
billing-accounts reactivate	POST /v1/billing_accounts/{id}/reactivate	Reativar conta de cobrança
billing-accounts subscriptions	GET /v1/billing_accounts/{id}/subscriptions	Listar assinaturas da conta
billing-accounts suspend	POST /v1/billing_accounts/{id}/suspend	Suspender conta de cobrança

Exemplos

--params carrega parâmetros de query e de caminho (id, página, filtros); --json carrega o corpo da requisição; --fields limita os campos que voltam — vale a pena em todo list/get, para economizar contexto. Veja Flags globais para a referência completa.

# Listar contas de cobrança
kobana billing billing-accounts list \
  --fields "id,public_id,external_id,currency,billing_email"

# Obter conta de cobrança
kobana billing billing-accounts get --params '{"id": "BILLING_ACCOUNT_ID"}'

# Criar conta de cobrança
kobana billing billing-accounts create --json '{"customer": "CUSTOMER"}'

# Atualizar conta de cobrança
kobana billing billing-accounts update \
  --params '{"id": "BILLING_ACCOUNT_ID"}' \
  --json '{"external_id": "EXTERNAL_ID", "name": "NAME", "email": "EMAIL"}'

# Fechar conta de cobrança (POST /close)
kobana billing billing-accounts close \
  --params '{"id": "BILLING_ACCOUNT_ID"}' \
  --json '{"reason": "REASON"}'

# Fechar conta de cobrança
kobana billing billing-accounts delete \
  --params '{"id": "BILLING_ACCOUNT_ID"}' \
  --dry-run

Próximos passos

• Faturas
• Introspecção de schema — todos os parâmetros que este recurso aceita.