Meios de pagamento

Os cartões e demais meios salvos de um cliente, e qual deles é o padrão.

Comando	HTTP	Descrição
payment-methods list	GET /v1/payment_methods	Listar métodos de pagamento
payment-methods create	POST /v1/payment_methods	Criar método de pagamento
payment-methods get	GET /v1/payment_methods/{id}	Obter método de pagamento
payment-methods update	PATCH /v1/payment_methods/{id}	Atualizar validade do cartão
payment-methods delete	DELETE /v1/payment_methods/{id}	Remover método de pagamento
payment-methods set-default	POST /v1/payment_methods/{id}/set-default	Definir método como padrão

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 métodos de pagamento
kobana billing payment-methods list \
  --fields "id,public_id,external_id,billing_account_id,credit_card_id"

# Obter método de pagamento
kobana billing payment-methods get --params '{"id": "PAYMENT_METHOD_ID"}'

# Criar método de pagamento
kobana billing payment-methods create \
  --json '{"billingAccountId": "BILLINGACCOUNTID", "type": "card"}'

# Atualizar validade do cartão
kobana billing payment-methods update \
  --params '{"id": "PAYMENT_METHOD_ID"}' \
  --json '{"exp_month": 0, "exp_year": 0}'

# Definir método como padrão
kobana billing payment-methods set-default \
  --params '{"id": "PAYMENT_METHOD_ID"}'

# Remover método de pagamento
kobana billing payment-methods delete \
  --params '{"id": "PAYMENT_METHOD_ID"}' \
  --dry-run

Próximos passos

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