Idempotência

Timeout de rede não diz se a cobrança foi criada do outro lado. Envie um cabeçalho Idempotency-Key em todo POST que cria dinheiro (cobrança, saque) para que reenviar a mesma requisição nunca duplique a operação.

curl -X POST https://stacepay.com.br/api/v1/charges \
  -H "Authorization: Bearer nvx_live_..." \
  -H "Idempotency-Key: pedido-8231" \
  -H "Content-Type: application/json" \
  -d '{"method":"pix","amount":5000,"customer":{...}}'

Regras

Mesma chave + mesmo corpo, ainda em processamento → 409 idempotency_key_in_progress. Aguarde e não reenvie de imediato.
Mesma chave + mesmo corpo, já concluída → devolve a resposta original, byte a byte, com o cabeçalho Idempotent-Replay: true.
Mesma chave + corpo diferente → 422 idempotency_key_reused. Use uma chave nova para cada operação distinta.

A chave fica registrada por 24 horas. Use um identificador seu já único o código do pedido interno, por exemplo em vez de um valor aleatório gerado a cada tentativa.