Conheça a API da SwitchPay
Cobranças por cartão, Pix e boleto, com divisão do valor entre contas e avisos automáticos.
Com esta API você cria cobranças (cartão, Pix e boleto), divide o valor de cada venda entre contas (split), consulta transações e recebe avisos automáticos (webhooks) quando um pagamento muda de situação.
Comece por aqui
Seu primeiro Pix
Do zero até um Pix pago no sandbox, em 4 passos. Nenhum dinheiro roda.
Como autenticar
A chave de API: onde vai, e a diferença entre a de teste e a de produção.
Sandbox
O ambiente de testes: o que é simulado e como pagar uma cobrança de mentira.
Referência da API
Todas as rotas, com exemplos e botão pra testar na hora.
O que você faz com a API
Cobrar
Você cria uma intenção de pagamento e confirma. Vale pra cartão de crédito, Pix e boleto. Pix e boleto podem ser criados e confirmados numa chamada só.
Dividir o valor da venda
Na mesma chamada da cobrança você diz quem recebe quanto. A resposta já traz o que cada um vai receber e quando.
Receber cartão sem tocar no número
O número do cartão vai direto do navegador do comprador pro nosso cofre. O seu servidor recebe só um código de uso único pra confirmar a cobrança.
Acompanhar o que aconteceu
Consulte uma venda, liste as vendas da sua empresa, ou deixe a SwitchPay avisar o seu sistema quando um pagamento mudar de situação.
Ambientes
| Ambiente | Endereço | Chave |
|---|---|---|
| Sandbox | https://api.sandbox.switchpay.app.br | swp_test_… |
| Produção | https://api.switchpay.app.br | swp_live_… |
A API é a mesma nos dois. O que muda no sandbox está em Sandbox.
Antes de integrar, vale ler
Erros
O formato de toda resposta de erro e a lista de códigos.
Idempotência
Como repetir uma chamada sem cobrar duas vezes.
Valores monetários
Como os valores em dinheiro são escritos.
Limites de chamadas
Quantas chamadas por minuto cada chave pode fazer.
Versão desta documentação
Contrato 2.0.1. O que mudou em cada versão está no Changelog do contrato; as regras de mudança, em Versionamento.
Precisa de ajuda?
Fale com o seu contato na SwitchPay. Se a integração for por IA, a doc inteira está em texto em
/llms.txt.