Disponível hoje na FaciPay
Popup / overlay (web)
Estilo PayPal: uma janela sobreposta à tua página. O cliente fica no contexto do
teu site e o pagamento corre numa janela isolada. É o que a
FaciPay JS SDK faz hoje.
Por agora, só o popup/overlay (web) e o WebView hospedado (mobile) estão disponíveis.
Checkout hospedado por redirect, iframe embebido e elementos custom ainda não existem —
estão listados abaixo apenas como referência para planeamento futuro.
Referência para planeamento — Stripe
| Padrão | O que é | Esforço | Controlo visual | Sai do site? |
|---|---|---|---|---|
| Checkout hospedado (redirect) | Página de pagamento hospedada; redirect e volta | Baixo | Baixo | Sim |
| Embedded Checkout (iframe) | A página de checkout embebida na tua página | Baixo–médio | Médio | Não |
| Payment Element / Elements | Componentes de UI para um checkout custom | Alto | Total | Não |
| Payment Links | URL partilhável, sem código | Nenhum | Baixo | Sim |
| Express Checkout Element | Botões de carteira 1-clique (Apple/Google Pay, Link) | Baixo | Baixo | Não |
Referência para planeamento — PayPal
| Padrão | O que é | Sai do site? |
|---|---|---|
| Smart Payment Buttons (popup) | Aprovação numa janela popup PayPal | Não (popup) |
| Smart Payment Buttons (redirect) | Aprovação por redirect (fallback mobile) | Sim |
| Hosted/Advanced Card Fields | Campos de cartão embebidos e personalizáveis | Não |
| Pay Later / messaging | Mensagens de “pagar depois”/prestações | Não |
| Checkout from cart/product (Express) | Botão de checkout direto no produto/carrinho | Não (popup) |
Como mapeiam ao fluxo FaciPay
O fluxo de backend da FaciPay (criar ordem →referenceNumber → confirmar por webhook) é
independente da forma de UX. Qualquer padrão reutiliza o mesmo createPaymentOrder e o
mesmo webhook; só muda onde o cliente introduz o pagamento:
- Popup/overlay (atual):
generateButton()+.render()abrem a janela de checkout. - Redirect/hospedado (futuro): redirecionar para o checkout (
www1.facipay.co.ao/checkout) e voltar pelosreturnUrl/cancelUrl. - Embebido (futuro): a mesma página de checkout dentro de um iframe.
- Link de pagamento (futuro): gerar a ordem e partilhar o URL do checkout, sem SDK.