Saltar para a documentação
API

Iniciar um pagamento

A ligação que compra um plano pago.

POST/billing/checkout

Executa a chamada real no seu espaço de trabalho.

POST /billing/checkout

A ligação que compra um plano pago.

Exemplo

Requer billing:write. plan é starter, business ou enterprise, e interval é month, por omissão, ou year. Nada é cobrado até a pessoa pagar lá, e o plano começa quando o tiver feito.

curl
curl -X POST "$OE/billing/checkout" -H "$AUTH" -H 'content-type: application/json' \  -d '{ "plan": "business", "interval": "year" }'
Resposta
{ "object": "checkout", "url": "https://checkout.example.com/c/3Hq8vXnP2sT6kL0w" }

Um espaço de trabalho que já paga um plano dá um 409 plan_conflict: altere antes o plano no portal de faturação. Um plano ou um intervalo que esta instalação não vende dá um 422 plan_unavailable.

Nada se paga através da API. A ligação abre a página do prestador de pagamentos, onde a pessoa paga, muda o cartão ou cancela, como faz a partir da app.

Um token de acesso OAuth precisa de um código de verificação para esta chamada. Até a aplicação ter verificado um nos últimos 60 minutos, a chamada responde 403 step_up_required e não altera nada. A uma chave de API nunca é pedido. A página Autenticação mostra como pedir um código e verificá-lo.

Referência