RIVOX

Criar payment intent

Criar uma intenção de pagamento com POST /v1/payment_intents e idempotência.

POST /v1/payment_intents cria a intenção. Nenhum movimento financeiro acontece ainda: a intenção nasce em requires_payment_method e só a confirmação a executa.

Pedido

CampoTipoObrigatórioNotas
amountinteiroSimValor na menor unidade da moeda (centavos).
currencystringNãoCódigo ISO-4217. Predefinição MZN.
metadataobjectoNãoPares chave/valor devolvidos nos eventos.
curl -X POST https://api.rivox.co.mz/v1/payment_intents \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: pi-2026-000148" \
  -d '{
    "amount": 25000,
    "currency": "MZN",
    "metadata": { "order": "148" }
  }'

Resposta

{
  "data": {
    "object": "payment_intent",
    "id": "pi_rvx_01J...",
    "amount": 25000,
    "currency": "MZN",
    "status": "requires_payment_method",
    "payment_method": null,
    "normalized_error": null,
    "environment": "sandbox",
    "created_at": "2026-09-02T10:41:00Z"
  },
  "meta": { "request_id": "req_..." }
}
  • Código HTTP: 201.
  • Evento emitido: payment_intent.created.
  • Erros: invalid_amount, insufficient_scope, idempotency_key_reuse.
  • Escalão de rate limit: financeiro.
AnteriorVisão geralSeguinteConfirmar pagamento