O que dá para fazer com a API#
| Você quer | Use | Guia |
|---|---|---|
| Receber por Pix (QR Code e copia e cola) | POST /transactions com payment_method: "pix" |
Cobrar com Pix |
| Receber cartão dentro da sua página, na moeda do comprador | POST /elements/checkout + Throne Elements |
Cartão: como funciona |
| Receber cartão do comprador brasileiro, com a página em português, o CPF pedido na tela e o botão e a moldura ajustados pela API | POST /elements/checkout/br + Throne Elements |
Checkout Brasil |
| Cobrar um segundo produto sem pedir o cartão de novo | POST /elements/checkout com one_click_from |
Upsell em um clique |
| Cobrar no cartão a cada ciclo, sozinho | POST /elements/checkout com recurrence |
Recorrência |
| Receber pagamento internacional por botão embutido | POST /global/checkout + iframe |
Internacional (Paycore) |
| Ver o saldo da conta | GET /balance |
Saldo e saques |
| Sacar por Pix ou cripto | POST /withdrawals |
Saldo e saques |
| Saber na hora que uma venda foi paga | Webhook transaction.paid |
Webhooks |
URL base de todas as chamadas:
https://app.thronecorporate.com/api/v1Por onde começar#
- Gere uma chave de API no painel, em Chaves de API.
- Leia Comece aqui: autenticação,
Idempotency-Key, tempo de resposta e formato dos erros. São cinco minutos e evitam a maior parte dos problemas. - Veja Limites e tempos e Como testar. Não existe ambiente de testes separado.
- Siga o guia do meio de pagamento que você vai usar.
- Cadastre a URL do seu webhook no painel e valide a assinatura, como em Webhooks.
- Antes de abrir as vendas, passe pelo Checklist de verificação.
Cartão: qual guia é o seu#
O cartão é sempre o mesmo Throne Elements, criado pelo POST /elements/checkout ou, para o comprador brasileiro, pelo Checkout Brasil. No checkout comum, o que muda é o comportamento do checkout, conforme a adquirente. Com mais de uma adquirente habilitada na conta, cada site escolhe a dela pelo campo acquirer (como escolher). As habilitadas aparecem no painel, em Documentação da API, e em GET /elements/acquirers.
| Adquirente | Verificação do banco | Navegador de app (Instagram, Facebook) | Tentativas por checkout | Guia |
|---|---|---|---|---|
| Sterling | Não tem: aprova ou recusa na hora | Tudo dentro do elemento | 5 | Sterling |
| Imperium | Não tem: o resultado sai na própria tentativa (uma recusa pode levar até 25 segundos) | Tudo dentro do elemento | 5 | Imperium |
| NovaCorp | Abre uma janela de verificação; a tela do banco aparece nela quando ele pede | A própria aba vai para a página segura de pagamento, sem evento na sua página | 6 | NovaCorp |
| Eminence | Pode pedir; a tela do banco aparece dentro do próprio elemento | Tudo dentro do elemento | 5 | Eminence |
| Apex | Não tem: aprova ou recusa na hora | Tudo dentro do elemento | 5 | Apex |
| ShadowBank | Não tem: aprova ou recusa na hora | Tudo dentro do elemento | 5 | ShadowBank |
| Vortex | Não tem: aprova ou recusa na hora | Tudo dentro do elemento | 5 | Vortex |
A validade do checkout é de 24 horas nas seis. O valor máximo por venda depende da adquirente e varia com a moeda e com a cotação do dia. A comparação completa está em Comparar adquirentes.
Nas seis, você manda o valor na moeda do comprador e ele paga nessa moeda; o seu saldo é creditado em reais, pela cotação fixada na criação. Veja Moedas e limites.
Duas formas de cobrar mais de uma vez entram pelo mesmo endpoint, como campos opcionais, e hoje só a Apex as aceita: Upsell em um clique, para cobrar um segundo produto sem pedir o cartão de novo, e Recorrência, para a cobrança que se repete sozinha.
Para assistentes de código e ferramentas automáticas#
Toda a documentação existe também em texto puro, para quem integra com ajuda de um assistente de código:
/llms.txt: índice curto, com um link por guia e a data da última atualização./docs/llms-full.txt: todos os guias num arquivo só.- Qualquer guia em Markdown: acrescente
.mdao endereço (por exemplo,/docs/pix.md). /openapi.jsone/openapi.yaml: especificação OpenAPI 3.1 com todos os campos e respostas.- Changelog: o que mudou, com data.