Primeiros passos — Integração de pagamentos
Primeiros passos — Integração de pagamentos
Este guia é para quem vai conectar um gateway ou adquirente à plataforma Wake como conector de pagamento customizado.
O que você vai precisar
- Um servidor com endpoint HTTPS acessível publicamente
- Contrato com o gateway ou adquirente que você vai integrar
- Acesso ao painel administrativo para configurar o conector
Antes de iniciar, leia o processo de homologação. Conectores customizados precisam ser validados antes de ir para produção.
Passo 1 — Entender o fluxo do conector
Wake envia os dados do pedido ao seu endpoint. Você processa com o gateway e devolve o resultado. O contrato cobre as seguintes etapas:
| Etapa | O que acontece |
|---|---|
| Tokenize | Wake envia dados do cartão para você armazenar com segurança |
| Authorize | Wake solicita a autorização do pagamento |
| Capture | Wake solicita a captura após confirmação do pedido |
| Cancel | Wake solicita o cancelamento/estorno |
| Chargeback | Notificação de chargeback recebida pelo gateway |
Passo 2 — Implementar os endpoints
Implemente cada endpoint no seu servidor seguindo os contratos de payload documentados. Comece por Tokenize e Authorize — são obrigatórios para o fluxo básico funcionar.
👉 Tokenize
👉 Authorize Split
👉 Capture
👉 Cancel
Passo 3 — Configurar o conector no painel
Com os endpoints implementados, registre o conector no painel administrativo informando as URLs de cada operação e as credenciais de autenticação entre Wake e seu servidor.
Passo 4 — Configurar no template da loja
O conector precisa ser ativado no template do Storefront para aparecer como opção de pagamento no checkout.
Passo 5 — Testar e homologar
Realize testes de ponta a ponta cobrindo os cenários de sucesso, falha e cancelamento antes de solicitar a homologação.
Updated about 21 hours ago