Recipes

Padrões prontos para colar — SaaS, Direct Response, E-commerce. Backend + frontend + lista de eventos. Tudo testado contra a API real.

Recipes são integrações completas e prontas para colar. Cada uma vem com:

Backend (Node) com criação de recurso + webhook handler
Frontend (HTML+JS) quando aplicável, usando @zhexio/zhex-js
Lista de eventos a tratar
Pitfalls comuns

A Zhex foca em três verticais que cobrem ~95% das integrações de devs BR:

SaaS — assinatura mensal/anual com cartão (BR + internacional), trial e dunning
Direct Response / Infoproduto — landing → checkout 1-step (PIX ou cartão) → bump → upsell 1-click
E-commerce — order bump, PIX 1-step, webhook → fulfillment, refund

Tudo que envolve frete, inventário, multi-step UI, customer portal, plan switch, NF-e, email transacional fica do seu lado — a Zhex te dá o rail de cobrança, não a plataforma de e-commerce/SaaS inteira.

Os três verticais

SaaS subscription

Mensal/anual com cartão, trial e dunning automático

Direct Response

Landing → PIX 1-step / cartão → bump → upsell 1-click via pm_*

E-commerce

Order bump, PIX, webhook → fulfillment, UTM server-side, refund

Operação em produção

Padrões para quando você já tem cobrança rodando e quer fechar o loop de operação.

Webhook → email transacional

Recibo, dunning e chargeback notice via SendGrid / Resend / Postmark / SES

Reconciliation diária

Match entre Zhex e seu BD via cursor pagination — captura webhooks perdidos, divergências de valor, refunds órfãos

Capacidades técnicas

Hosted Checkout

Link gerado pelo dashboard, redireciona, webhook ao pagar — sem código no frontend

One-click PIX

Cartão salvo (pm_*) para próxima compra; PIX Auto em desenvolvimento

Como usar

Copie o backend. Os snippets são em Node (TypeScript) usando @zhex/node ou fetch direto. Veja Integração.
Adapte o frontend. O HTML+JS usa @zhexio/zhex-js para tokenização — copie e adapte para seu framework (React, Vue, etc.).
Configure os webhooks. Cada recipe lista os eventos críticos. Sem webhook handler, você fica sem visibilidade do estado real da transação.
Teste em test mode primeiro. Use zk_test_*/zsk_test_* e os test helpers para validar antes de subir live.

Esta página foi útil?