Pagamentos

Meios de Pagamento Disponíveis

Meio	Tipo	Online
Dinheiro	Presencial	Não
Cartão de débito	Presencial	Não
Cartão de crédito	Online	Sim
Pix	Online	Sim
PicPay	Online	Sim

Cada restaurante habilita apenas as formas que deseja aceitar nas configurações.

---

Fluxo Pix

1. Cliente seleciona Pix e confirma pedido
2. API gera cobrança no gateway Pix
3. API retorna QR Code e código Pix Copia e Cola
4. Cliente paga no banco
5. Gateway notifica API (webhook)
6. API atualiza pedido para accepted
7. Notificação push para o cliente

• Expiração: A cobrança Pix expira conforme configuração do gateway

• Cancelamento: Se o cliente não pagar, o pedido fica em pending e pode ser cancelado manualmente

---

Fluxo PicPay

1. Cliente seleciona PicPay
2. API cria cobrança no PicPay
3. API retorna link de pagamento
4. Cliente redireciona para link PicPay
5. PicPay chama webhook da API
6. Pedido atualizado para accepted

---

Fluxo Cartão de Crédito

1. Cliente insere dados do cartão no app
2. App chama POST /transactions
3. API processa com gateway
4. Gateway retorna autorização
5. Pedido é criado já pago

Erros possíveis:

• CARD_NOT_VALID — dados do cartão inválidos (número, CVV, validade)

• PAYMENT_TRANSACTION_DENIED — cartão com limite insuficiente ou bloqueado

---

Pagamentos Presenciais

Dinheiro, débito e outros métodos "na entrega" não têm fluxo online. A forma de pagamento é apenas registrada no pedido para o restaurante se preparar (ex: levar troco).

---

Estorno

Não há API de estorno automático. O lojista deve realizar o estorno diretamente no painel do gateway de pagamento.