Pagamentos
PIX, PIX Automático, boleto, cartão (3DS, parcelamento, BIN routing), refund e chargeback — todos sob a mesma API.
A Zhex unifica os principais meios de pagamento brasileiros e internacionais sob uma única abstração (PaymentIntent). Cada método tem nuances que afetam taxa, tempo de liquidação e tratamento de falha. Esta seção é o manual operacional.
Independente do método, o ciclo de vida é o mesmo: requires_payment_method → requires_confirmation → processing → succeeded (ou requires_action quando o cliente precisa fazer algo, como pagar o PIX ou completar 3DS).
Métodos disponíveis
PIX
Menor custo, melhor aprovação, liquidação em segundos. Default recomendado no Brasil.
PIX Automático
Débito recorrente direto da conta — em desenvolvimento.
Boleto
Necessário para clientes sem cartão/PIX. ~70% aprovação, D+1.
Cartão
Hosted fields (zhex.js) + 3DS automático + parcelamento BR + BIN routing.
Operações pós-cobrança
Refund
Total ou parcial — janelas e tempos de liquidação por método.
Chargeback
Reembolso compulsório — registrar baixa contábil e prevenir.
Comparativo rápido
| Método | Custo* | Aprovação | Liquidação | Refund |
|---|---|---|---|---|
| PIX | 0,5–1% | 99%+ | Segundos (D+0) | < 1h (MED) |
| PIX Automático | 0,5% | 95%+ | Segundos (D+0) | < 1h |
| Boleto | R$ 1,90–3,90 | ~70% | D+1 | D+5 |
| Cartão BR | 2,5–4,5% | 80–88% | D+30 (sem antecipação) | D+30 |
| Cartão internacional | 3,5–6% | 75–85% | D+30 | D+30 |
* Taxas variáveis por volume e categoria. Veja seu painel para taxas exatas.
Atualizado em