PT EN

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êntimosExemplo (amount_cents)ResultadoRequer sandbox advanceDescrição
00125000confirmedNãoO pagamento é confirmado de imediato e dispara os webhooks de confirmação.
02125002failedNãoO pagamento falha de imediato com uma recusa simulada.
05125005expiredNãoA sessão de pagamento expira sem liquidação.
09125009pendingSimO pagamento fica pendente até ser avançado via sandbox advance.
outro125013confirmedNãoQualquer 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.

bash
gotactl sandbox advance
gotactl sandbox advance --payment pay_7QmXc2Lk9ZtR4wYb --outcome expired

Disparar 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:

EventoComando
customer.createdgotactl events trigger customer.created
account.createdgotactl events trigger account.created
invoice.issuedgotactl events trigger invoice.issued
invoice.paidgotactl events trigger invoice.paid
payment.receivedgotactl events trigger payment.received
reading.acceptedgotactl events trigger reading.accepted
webhook.testgotactl events trigger webhook.test

Próximos passos