# Throne API

> API REST do gateway Throne: cobrança Pix, checkout de cartão embutido em várias moedas (adquirentes Sterling, Imperium, NovaCorp, Eminence, Apex e ShadowBank, escolhidas por chamada no campo `acquirer`), botão internacional (Paycore), saldo, saques e webhooks assinados.

Atualizado em: 2026-11-03
Versão da API (OpenAPI info.version): 1.13.0
URL base: https://app.thronecorporate.com/api/v1
Autenticação: Authorization: Bearer <public_key>:<secret_key>
Toda chamada que cria algo exige o header Idempotency-Key. Tabela de repetição: https://app.thronecorporate.com/docs/comecar.md
Erros com código fixo (inclusive pix_not_enabled, quando a conta não recebe por Pix): https://app.thronecorporate.com/docs/errors.md
Mudanças com data: https://app.thronecorporate.com/docs/changelog.md

Documentação completa em um arquivo só: https://app.thronecorporate.com/docs/llms-full.txt
Especificação OpenAPI 3.1: https://app.thronecorporate.com/openapi.json (também em https://app.thronecorporate.com/openapi.yaml)
Coleção do Postman: https://app.thronecorporate.com/docs/postman

## Começar

- [Documentação da API](https://app.thronecorporate.com/docs.md): Mapa da API do Throne: Pix, cartão em várias moedas, internacional, saldo, saques e webhooks.
- [Comece aqui](https://app.thronecorporate.com/docs/comecar.md): Chaves de API, URL base, Idempotency-Key com tabela única de repetição, tempo de resposta e formato das respostas.
- [Limites e tempos](https://app.thronecorporate.com/docs/limites.md): Limites por endpoint e por adquirente, tempo de resposta, Retry-After e o que fazer em cada caso.
- [Como testar](https://app.thronecorporate.com/docs/testar.md): Testar sem ambiente de testes: valor baixo, idioma do checkout e erros provocados de propósito.
- [Checklist de verificação](https://app.thronecorporate.com/docs/checklist.md): Roteiro para conferir, passo a passo, se a integração está pronta para vender.

## Pix

- [Cobrar com Pix](https://app.thronecorporate.com/docs/pix.md): Criar cobrança Pix, mostrar o QR Code, acompanhar o pagamento e vender produto físico.
- [Pix com a Shadow Pix](https://app.thronecorporate.com/docs/pix/shadowpix.md): Regras e comportamento do Pix quando a conta é atendida pela Shadow Pix: faixa de R$ 10,00 a R$ 5.000,00, timeout de 60 segundos na emissão, prazo do código no banco, dedução por pedido, confirmação pelo webhook e saque por Pix.

## Cartão

- [Cartão: como funciona](https://app.thronecorporate.com/docs/cartao.md): Checkout de cartão embutido na sua página, comum às adquirentes Sterling, Imperium, NovaCorp, Eminence, Apex, ShadowBank e Vortex, com escolha da adquirente por chamada e venda em 48 moedas.
- [Comparar adquirentes](https://app.thronecorporate.com/docs/cartao/comparar.md): Sterling, Imperium, NovaCorp, Eminence, Apex, ShadowBank e Vortex lado a lado: verificação do banco, caminhos de pagamento, tentativas, limites, eventos e webhook.
- [Escolher a adquirente](https://app.thronecorporate.com/docs/cartao/escolher.md): O campo acquirer, as adquirentes habilitadas na conta, os limites de cada uma e o que fazer quando o valor passa do máximo.
- [Moedas e limites](https://app.thronecorporate.com/docs/cartao/moeda.md): As 48 moedas aceitas, o mínimo e o máximo por moeda, como a cotação do dia muda os limites e como o seu saldo é creditado.
- [Throne Elements](https://app.thronecorporate.com/docs/cartao/elements.md): Atributos do elemento, eventos com código estável, sandbox, página de uma tela só e navegador de app.
- [Checkout Brasil](https://app.thronecorporate.com/docs/cartao/brasil.md): Checkout de cartão para o comprador brasileiro: página sempre em português, CPF pedido na tela, comprador de qualquer país e botão e moldura ajustáveis pela API, com o mesmo Throne Elements e o mesmo webhook.
- [Status e ciclo de vida](https://app.thronecorporate.com/docs/cartao/status.md): Os status de uma venda de cartão, quando cada um acontece em cada adquirente e o que fazer.
- [Upsell em um clique](https://app.thronecorporate.com/docs/cartao/oneclick.md): Cobrar um segundo produto sem pedir o cartão de novo: o campo one_click_from, a resposta one_click e o que fazer quando ela vem false.
- [Recorrência](https://app.thronecorporate.com/docs/cartao/recorrencias.md): Cobrança que se repete sozinha no cartão: os sete ciclos, o campo recurrence, as situações, o cancelamento e como acompanhar cada cobrança.
- [Cartão com a Sterling](https://app.thronecorporate.com/docs/cartao/sterling.md): Regras e comportamento do checkout quando a venda passa pela Sterling (acquirer sterling).
- [Cartão com a Imperium](https://app.thronecorporate.com/docs/cartao/imperium.md): Regras e comportamento do checkout quando a venda passa pela Imperium (acquirer imperium).
- [Cartão com a NovaCorp](https://app.thronecorporate.com/docs/cartao/novacorp.md): Regras e comportamento do checkout quando a venda passa pela NovaCorp (acquirer novacorp).
- [Cartão com a Eminence](https://app.thronecorporate.com/docs/cartao/eminence.md): Regras e comportamento do checkout quando a venda passa pela Eminence (acquirer eminence): verificação do banco dentro do elemento, navegador de app, pagamento em análise, códigos de erro e webhook.
- [Cartão com a Apex](https://app.thronecorporate.com/docs/cartao/apex.md): Regras e comportamento do checkout quando a venda passa pela Apex (acquirer apex): sem verificação do banco, tudo dentro do elemento, navegador de app, pagamento em análise, códigos de erro e webhook.
- [Cartão com a ShadowBank](https://app.thronecorporate.com/docs/cartao/shadowbank.md): Regras e comportamento do checkout quando a venda passa pela ShadowBank (acquirer shadowbank): sem verificação do banco, tudo dentro do elemento, navegador de app, pagamento em análise, códigos de erro e webhook.
- [Cartão com a Vortex](https://app.thronecorporate.com/docs/cartao/vortex.md): Regras e comportamento do checkout quando a venda passa pela Vortex (acquirer vortex): sem verificação do banco, tudo dentro do elemento, navegador de app, pagamento em análise, códigos de erro e webhook.
- [Server-to-server (parceiros)](https://app.thronecorporate.com/docs/cartao/server-to-server.md): Integração por API, sem Throne Elements, na adquirente Eminence: para gateways, subadquirentes e agregadores que já têm checkout próprio e querem oferecer a Eminence aos seus sellers. Habilitação caso a caso.
- [Server-to-server na Vortex](https://app.thronecorporate.com/docs/cartao/vortex-direto.md): Integração por API, sem Throne Elements, na adquirente Vortex: cobrança na moeda do comprador, para quem já tem checkout próprio. Habilitação caso a caso.
- [Server-to-server na ShadowBank](https://app.thronecorporate.com/docs/cartao/shadowbank-direto.md): Integração por API, sem Throne Elements, na adquirente ShadowBank: cobrança na moeda do comprador, com recorrência e upsell em um clique, para quem já tem checkout próprio. Habilitação caso a caso.

## Internacional

- [Internacional (Paycore)](https://app.thronecorporate.com/docs/internacional.md): Botão de pagamento internacional embutido na sua página.

## Conta

- [Saldo e saques](https://app.thronecorporate.com/docs/saques.md): Consultar saldo e pedir saque por Pix ou cripto pela API.
- [Webhooks](https://app.thronecorporate.com/docs/webhooks.md): Eventos enviados ao seu servidor, assinatura HMAC, retentativas, quando chegam e conversão de campanha pelo servidor.

## Referência

- [Erros](https://app.thronecorporate.com/docs/errors.md): Cada código de erro da API: status, causa, o que fazer e se pode repetir.
- [Exemplos por linguagem](https://app.thronecorporate.com/docs/sdks.md): Cliente HTTP mínimo pronto para copiar em PHP, Node.js e Python, com timeout e repetição segura.
- [Changelog](https://app.thronecorporate.com/docs/changelog.md): O que mudou na API e na documentação, com data.
- [Status](https://app.thronecorporate.com/docs/status.md): Verificação ao vivo da API.