Fluxo de integração

🧠 Explicação por etapa

1. Criação do smart checkout

O parceiro Paytime inicia o fluxo a partir do seu backend, definindo:

• valor;
• descontos;
• métodos de pagamento;
• dados do cliente;
• configurações do checkout;
• etc.

Faz uma requisição para POST /checkout

---

2. Geração do checkout_token

A Paytime valida e cria o smart checkout.

A resposta retorna:

• checkout_token;
• demais dados do smart checkout;

👉 Esse token é a chave de todo o fluxo.

---

3. Renderização do smart checkout

O parceiro Paytime renderiza o smart checkout na interface para o comprador.

Pode ocorrer via:

• Redirect (Hosted);
• iFrame / WebView;
• SDK Mobile;

👉 Aqui começa a experiência do usuário.

---

4. Interação do usuário e pagamento

O comprador:

• preenche dados;
• escolhe método (Pix, cartão, etc.);
• confirma pagamento;

---

5. Processador de pagamentos

A Paytime executa:

• validações;
• antifraude (quando aplicável);
• decisão de fluxo (3DS, fallback, etc.);
• comunicação com autorizadores (Bacen, adquirentes, bandeiras, emissores, etc.);
• processa o retorno da transação (aprovado, negado, etc.);

---

6. Webhook

A Paytime envia um webhook com o resultado da transação para o parceiro.

Eventos que você deve observar:

🧾 new-sub-transaction

• Enviado quando o pagamento é realizado, uma nova transação é criada.

🔄 updated-sub-transaction

• Enviado quando o status da transação é alterado.

---

7. Atualização do status

O parceiro Paytime recebe o webhook e atualiza o status do pedido/ordem em seu sistema.