Entrar no painel
Índice

(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ãoO que acontece
AprovarO 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.
RecusarA 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 500 ao webhook e ver as retentativas chegarem, ou reenviar o evento do painel (Eventos, Reenviar).
  • O estorno: estornar o pagamento aprovado com POST /v1/refunds e receber refund.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).