(06) Receber pagamentos
Modo teste
Pagar sem dinheiro, com os botões aprovar e recusar do checkout.
Pagar sem dinheiro
Uma sessão criada com uma chave sk_test_ abre o mesmo checkout que o comprador vai ver em produção, com a faixa Modo teste por cima. Não há banco nenhum do outro lado: depois de escolher o método e carregar em pagar, aparece um quadro "Modo teste: decida o resultado", com dois botões.
| Botão | O que acontece |
|---|---|
| Aprovar | O pagamento fica confirmado, a sessão passa a complete, o livro regista bruto, taxa e líquido no teu saldo de teste, e recebes payment.succeeded no endpoint de teste. |
| Recusar | A tentativa falha, recebes payment.failed com o motivo, e a sessão continua open: o comprador pode tentar outra vez. |
Os botões aparecem no Multicaixa Express, na referência e no BAI Paga, os métodos em que, a sério, o comprador confirma depois. No cartão não há espera: o pagamento de teste fica aprovado logo, como quando o Stripe aceita o cartão; para ensaiar uma recusa, usa um dos outros três. Onde o checkout pede um telemóvel, serve qualquer número angolano válido (9 dígitos a começar por 9, por exemplo 923456789). Nada sai para fora: nenhum SMS, nenhum pedido ao banco, nenhum cartão cobrado.
O que vale a pena ensaiar
- O caminho feliz: criar a sessão, aprovar, receber
payment.succeeded, e ver a encomenda marcada como paga pelo webhook (e não pelo regresso). - A recusa e a segunda tentativa: recusar, ver
payment.failed, tentar outra vez e aprovar. - O comprador que desiste: carregar em "Cancelar e voltar" e chegar ao
cancel_url. - O teu servidor em baixo: responder
500ao webhook e ver as retentativas chegarem, ou reenviar o evento do painel (Eventos, Reenviar). - O estorno: estornar o pagamento aprovado com
POST /v1/refundse receberrefund.created.
No painel
O painel tem uma faixa no topo que diz o modo e o muda. Em modo teste vês as sessões (Pagamentos), o saldo de teste, os eventos enviados e as chaves e endpoints de teste. Nada disto se mistura com produção.
O que o modo teste não prova
O modo teste prova a tua integração, e não o gateway: o tempo de confirmação do Multicaixa Express, o SMS do BAI Paga ou a página do Stripe só se veem em produção. O código é o mesmo nos dois modos; muda a chave (ver Chaves e modos).