Pagamentos para devs · BR ↔ Mundo

A infra de pagamentos do Brasil para o mundo.

Uma API HTTP-first para PIX, cartão, boleto e PIX Automático — com roteamento inteligente entre adquirentes, sandbox completo e idempotência nativa. No nível que devs já esperam de um Stripe.

Quickstart em 5 minFalar com vendas
API uptime99.99%
p50 latency87ms
PIX · cartão · boleto3 rails
API versionv1

Uma chamada. Tudo orquestrado.

Você cria um PaymentIntent, a Zhex roteia, faz failover, assina e entrega o evento. Sem polling, sem retry manual.

POST/v1/payment_intents
1// Node 18+ — fetch nativo, sem SDK.
2const res = await fetch('https://prometheus.zhex.io/v1/payment_intents', {
3 method: 'POST',
4 headers: {
5 Authorization: `Bearer ${process.env.ZHEX_SECRET_KEY}`,
6 'Idempotency-Key': crypto.randomUUID(),
7 'Content-Type': 'application/json',
8 },
9 body: JSON.stringify({
10 amount: 4990,
11 currency: 'BRL',
12 payment_method_types: ['pix', 'card'],
13 customer: 'cus_8HFq2…',
14 }),
15});
16 
17const intent = await res.json();
18console.log(intent.status); // → 'requires_payment_method'
Webhooks ao vivo
TEST MODE · whsec_test_…
    Construído para a era da API

    Detalhes que você sente no dia 30 de produção.

    Não é "uma API". São seis comportamentos que aparecem na primeira semana e te salvam pelos próximos cinco anos.

    Adquirente AAdquirente BAdquirente CAdquirente D

    Smart routing nativo

    6 adquirentes. Rota por custo, aprovação ou geografia. Failover automático com circuit breaker por provedor.

    payment_intent.ts
    type Status =
    |'created'
    |'requires_action'
    |'processing'
    |'succeeded'

    PaymentIntent state machine

    Estados explícitos. Cada transição emite evento. Você nunca faz polling — a Zhex te avisa.

    POST /v1/payment_intents
    curl -X POST \
    -H "Authorization: Bearer zsk_test_…" \
    -H "Idempotency-Key: 8b4e2c…" \
    -d '{ amount: 1000, currency: "BRL" }'
    cached for 24h
    200 OK · pi_3NJ…sQ4 cached

    Idempotency-Key

    Mesma chave + mesmo body = mesma resposta cacheada por 24h. Nunca mais cobre o cliente duas vezes.

    ADQUIRENTEAADQUIRENTEBADQUIRENTECADQUIRENTED

    Retry inteligente entre adquirentes

    Cartão recusou no provedor A? A Zhex tenta no B, depois no C, depois no D — em milissegundos, sem você escrever uma linha.

    charge.ts
    const res = await fetch(
    'https://prometheus.zhex.io/v1/payment_intents', {
    method: 'POST',
    headers: { Authorization, …,
    body: JSON.stringify(payload),
    });
    ●→200 OK·pi_3NJ…sQ4
    Node 18+cURL

    HTTP-first, sem dependência

    cURL e `fetch` nativo do Node 18+. Você integra hoje sem instalar pacote algum. SDK Node em desenvolvimento.

    js.zhex.io/elements
    iframe
    •••• •••• •••• 4242
    tokenizedtok_8HFq2…
    const { token } = await zhex.createToken(card)

    Tokenização PCI SAQ-A

    Hosted fields no browser do cliente. PAN/CVV nunca tocam seu servidor. Token single-use, TTL 15min.

    Cobertura global

    Pague no Brasil. Receba do mundo.

    PIX, cartão BR, multi-moeda e settlement em USD/EUR/GBP/BRL. A mesma API roteia entre adquirentes locais e cross-border, sem você dobrar o backend.

    world map
    Moedas suportadas
    BRL · USD · EUR · GBP · MXN
    Métodos brasileiros
    PIX · Cartão · Boleto · PIX Auto
    Cross-border
    LATAM · NA · EU · África · Ásia
    § Navegação

    Por onde começar.

    Quatro caminhos. Pegue o que faz sentido pro seu papel — eles convergem.

    Quickstart

    Sua primeira cobrança em 5 minutos. cURL ou Node — sem SDK.

    Conceitos

    PaymentIntent, Token, idempotência, webhooks e test mode.

    Referência da API

    Todos os endpoints da `/v1` documentados. Gerada da spec OpenAPI 3.1.

    Integração

    Padrões prontos com `fetch` nativo do Node 18+ e cURL. Retry, paginação e webhooks.