Cobrança

Gerar link de checkout (Stripe)

Cria uma página de checkout hospedada do Stripe e retorna a url para o usuário abrir no navegador — nada é cobrado até ele concluir lá. purpose:“wallet_topup” (exige amount > 0, na moeda da conta) gera um pagamento único que credita a carteira pré-paga; purpose:“add_card” gera uma página para salvar um cartão. Ação de conta: requer key escopada a TENANT (403 NUMBER_SCOPE_NOT_ALLOWED para key de número). Só Stripe.

Requer uma chave com escopo de tenant.

POST

billing

checkout

Gerar link de checkout (Stripe)

curl --request POST \
  --url https://pilotstatus.com.br/v1/billing/checkout \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "purpose": "wallet_topup",
  "amount": 50
}
'

{
  "url": "https://checkout.stripe.com/c/pay/cs_test_...",
  "purpose": "wallet_topup",
  "orderId": "cto_01HZX...",
  "amount": 50,
  "currency": "BRL"
}

Autorizações

x-api-key

string

header

obrigatório

Sua chave de API ps_

Corpo

application/json

purpose

string

obrigatório

Finalidade da página de checkout.

Exemplo:

"wallet_topup"

amount

string

Valor a creditar na carteira, na moeda da conta (obrigatório para wallet_topup).

Exemplo:

"50"

successUrl

string

URL de redirecionamento após o sucesso.

Exemplo:

"https://app.acme.com/billing/ok"

cancelUrl

string

URL de redirecionamento se cancelar.

Exemplo:

"https://app.acme.com/billing"

Resposta

Recarregar carteira

Remover número extra (On Demand)

Enviar mensagem

⌘I

Gerar link de checkout (Stripe)

curl --request POST \
  --url https://pilotstatus.com.br/v1/billing/checkout \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "purpose": "wallet_topup",
  "amount": 50
}
'

{
  "url": "https://checkout.stripe.com/c/pay/cs_test_...",
  "purpose": "wallet_topup",
  "orderId": "cto_01HZX...",
  "amount": 50,
  "currency": "BRL"
}