Skip to main content
Beta — o contrato da 1.0 em evolução, ainda não em produção. Os campos podem mudar até o lançamento.
A API do SwytchPay integra depósito, saque e conversão num único gateway que orquestra múltiplos provedores. Uma corretora pluga uma vez e opera em várias moedas, com redundância, roteamento e conciliação.

​
Conceitos

  • Depósito (deposit) — cobrança de entrada na moeda local (PIX, SPEI, PSE). A corretora cria, o pagador paga, o webhook confirma.
  • Saque (payout) — saída para chave PIX, CLABE ou carteira USDT.
  • Conversão (conversion) — troca o saldo de uma moeda por USDT, com taxa por par.
  • Saldo (balance) — disponível / pendente / bloqueado, por moeda.
  • Webhook — notificação assinada quando um recurso muda de status.
  • Modo test — universo paralelo (chaves pk_test_…) para integrar sem dinheiro real.

​
O que a 1.0 adiciona sobre a 0.1

  • currency em depósito, saque e saldo — opere BRL, MXN, COP, ARS. Sem currency, o default é BRL.
  • payment_method — o trilho: PIX, SPEI, OXXO, PSE, Nequi.
  • charge polimórfico — cada método devolve o que o pagador precisa: o EMV no PIX, uma URL de redirecionamento nos trilhos LATAM, o endereço no cripto.
  • Conversão por par — qualquer moeda para USDT, com taxa própria por par.
  • Cripto (USDT) — depósito e saque de USDT direto na carteira (endereço + rede). Trilho em Beta.

​
Princípios

  • Valor inteiro em centavos — amount, nunca decimal. Sem ambiguidade de vírgula.
  • Idempotência por external_id — repetir um POST devolve o recurso existente.
  • Webhook-first — reaja ao webhook, não faça polling.

​
Comece por aqui

Quickstart

Do zero ao depósito pago, em modo test.