RIVOX

Consultar pagamento

Consultar payment intents e charges, com boas práticas de polling e isolamento.

GET /v1/payment_intents/:id devolve o estado Rivox da intenção. GET /v1/charges/:id devolve a tentativa de execução associada, com sincronização controlada com o provedor enquanto o estado não for final.

curl https://api.rivox.co.mz/v1/payment_intents/pi_rvx_01J... \
  -H "Authorization: Bearer sk_test_..."

curl https://api.rivox.co.mz/v1/charges/ch_rvx_01J... \
  -H "Authorization: Bearer sk_test_..."

Consulta periódica

  • Consulte no máximo a cada poucos segundos; a sincronização com o provedor tem intervalo mínimo próprio.
  • Pare assim que o estado for final.
  • Prefira webhooks: a consulta serve como rede de segurança, não como mecanismo principal. Ver /webhooks.
  • Exceder o escalão de leitura devolve 429 com o cabeçalho Retry-After.

Isolamento

Um objecto só é visível para a conta e o ambiente que o criaram. Um identificador de outra conta, ou de outro ambiente, devolve 404 not_found — nunca 403.