Pular para o conteúdo principal

kobana billing credit-purchases

Comandos de kobana billing credit-purchases. Toda opção global (Opções globais) vale aqui.

ComandoHTTPDescrição
credit-purchases createPOST /v1/credit_purchasesComprar créditos

credit-purchases create​

Comprar créditos

kobana billing credit-purchases create [OPÇÕES]

POST /v1/credit_purchases

Gera e finaliza uma fatura avulsa (billing_reason = credit_purchase) com a quantidade de créditos de um produto do tipo credits, independente de assinatura. O saldo passa a valer quando a fatura é paga: o webhook invoice.paid traz line_items[].product_type e quantity.

Corpo da requisição

NomeTipoObrigatórioDescrição
product_idstring (uuid)simProduto do tipo credits.
quantityintegersimQuantidade de créditos (inteira; múltipla do incremento do produto).
billing_account_idstring (uuid)nãoID da conta de cobrança. Informe este ou billing_account_public_id.
billing_account_public_idstring (uuid)nãoIdentificador público da conta de cobrança.
price_idstring (uuid)nãoPreço a cobrar. Padrão: o preço padrão ativo do produto.
collection_methodstringnãomanual_charge (padrão): o cliente paga a fatura. charge_automatically: cobra o cartão padrão ao finalizar. Valores: charge_automatically, manual_charge.
due_datestringnãoVencimento. Padrão: o prazo de pagamento da conta.

Outros campos e objetos aninhados: kobana schema billing.credit-purchases.create.

Respostas

HTTPDescrição
201Fatura da compra, com os itens.
404Recurso não encontrado na organização atual.
422Corpo da requisição falhou na validação.