Simular pagamento (teste)
POST
/api/v1/charges/{id}/simulate-paymentMarca uma cobrança de teste como paga e dispara o webhook venda.aprovada. Só existe com a chave de teste (gp_test_); veja o guia do modo de teste.
Parâmetros
idtexto (no caminho)obrigatórioO id da cobrança de teste (32 caracteres). Não tem corpo.
Exemplo
curl -X POST https://app.grinnypay.com/api/v1/sandbox/charges/8f2c4b1e9a7d4c3b8e1f2a3b4c5d6e7f/simulate-payment \
-H "Authorization: Bearer $GRINNY_TEST_KEY"const resp = await fetch('https://app.grinnypay.com/api/v1/sandbox/charges/8f2c4b1e9a7d4c3b8e1f2a3b4c5d6e7f/simulate-payment', {
method: 'POST',
headers: { Authorization: `Bearer ${process.env.GRINNY_TEST_KEY}` },
});
const cobranca = await resp.json();Resposta
200 com a cobrança já com status pago, pago_em preenchido e "livemode": false. Repetir a chamada devolve a mesma cobrança, sem novo webhook.
Erros
| HTTP | Código | Quando |
|---|---|---|
| 403 | somente_chave_de_teste | Chave de produção (gp_live_) no endereço de teste. Cobrança real só é paga pelo Pix. |
| 404 | nao_encontrado | Cobrança de teste inexistente, de outra conta, ou é uma cobrança de produção. |
| 422 | dados_invalidos | A cobrança de teste já venceu: crie outra. |