Dados de teste e valores mágicos
Na sandbox, os pagamentos passam por um conector simulado: nenhum dinheiro se move e o resultado depende só do valor que envia. Assim pode testar cada caminho, incluindo falhas e pagamentos que ficam pendentes, sem esperar por um fornecedor real.
Valores mágicos
O conector lê os dois últimos dígitos de amount_cents (o valor em cêntimos). Por exemplo, 1 250,00 MZN enviados como 125000 terminam em 00 e confirmam de imediato; 125009 fica pendente.
| Últimos dois cêntimos | Exemplo (amount_cents) | Resultado | Requer sandbox advance | Descrição |
|---|---|---|---|---|
00 | 125000 | confirmed | Não | O pagamento é confirmado de imediato e dispara os webhooks de confirmação. |
02 | 125002 | failed | Não | O pagamento falha de imediato com uma recusa simulada. |
05 | 125005 | expired | Não | A sessão de pagamento expira sem liquidação. |
09 | 125009 | pending | Sim | O pagamento fica pendente até ser avançado via sandbox advance. |
outro | 125013 | confirmed | Não | Qualquer outro sufixo de cêntimos confirma de imediato por omissão. |
Cada resultado gera os mesmos eventos que um pagamento real: um pagamento confirmado envia payment.received e, quando liquida a factura, invoice.paid.
Avançar pagamentos pendentes
Um pagamento terminado em 09 fica pendente até o avançar. Sem opções, a CLI confirma todos os pagamentos pendentes da sandbox; com --payment e --outcome escolhe um pagamento e o resultado.
gotactl sandbox advance
gotactl sandbox advance --payment pay_7QmXc2Lk9ZtR4wYb --outcome expiredDisparar eventos
Para testar o seu receptor de webhooks sem montar o cenário à mão, a CLI cria na sandbox os dados que produzem estes eventos:
| Evento | Comando |
|---|---|
customer.created | gotactl events trigger customer.created |
account.created | gotactl events trigger account.created |
invoice.issued | gotactl events trigger invoice.issued |
invoice.paid | gotactl events trigger invoice.paid |
payment.received | gotactl events trigger payment.received |
reading.accepted | gotactl events trigger reading.accepted |
webhook.test | gotactl events trigger webhook.test |