Bem-vindo à Zhex
Plataforma de pagamentos BR-internacional para devs e SaaS — uma API, múltiplas adquirentes, sandbox completo.
Pagamentos sérios. Uma API. Sem fricção.
PIX, PIX Automático, boleto e cartões internacionais com roteamento inteligente entre adquirentes e failover automático por circuit breaker.
A Zhex é a infraestrutura de pagamentos para construir produtos sérios no Brasil e cruzando fronteiras. Uma única API expõe PIX, PIX Automático, boleto e cartões internacionais, com roteamento inteligente entre adquirentes (Stripe, Pagar.me, Asaas, PayPal, Rapyd) e failover automático via circuit breaker por provedor.
Esta documentação foi escrita para que você consiga rodar a primeira cobrança em menos de 5 minutos, mas também para servir de referência operacional quando você estiver em produção e precisar entender por que a Zhex roteou um pagamento para a Pagar.me e não para a Asaas.
Uptime SLO
Compromisso público com janela mensal.
p99 latência
Da request à resposta da API pública.
Time-to-first-charge
Do signup à primeira cobrança em test mode.
Adquirentes
Stripe, Pagar.me, Asaas, PayPal, Rapyd, Getnet.
Quickstart
Sua primeira cobrança em 5 minutos — chave de teste, curl e callback.
Conceitos
PaymentIntent, Token, Idempotência, Test mode.
Referência da API
Endpoints, parâmetros, exemplos. Gerada da spec OpenAPI 3.1.
Integração
Padrões prontos com `fetch` nativo do Node 18+ e cURL. Retry, paginação e webhooks sem dependência.
Como ler esta documentação
- Conceitos primeiro se você nunca integrou um gateway antes — explicam o modelo mental sem detalhe de endpoint.
- Pagamentos se você quer entender PIX, cartão, boleto, 3DS e PIX Automático em profundidade.
- API se você já sabe o que precisa — ela é gerada da spec OpenAPI 3.1 e bate 1-1 com o servidor.
- Segurança é leitura obrigatória antes de ir para produção: chaves, idempotência, webhooks, PCI.
Test mode é first-class
Toda chave zsk_test_* toca um mock acquirer que simula sucesso, falha, 3DS, refund e chargeback de forma determinística — sem nunca atingir adquirente real. Veja test mode.
Atualizado em