Confirmar pagamento
Executar uma intenção com POST /v1/payment_intents/:id/confirm usando cartão ou carteira móvel.
Nesta página
POST /v1/payment_intents/:id/confirm executa a intenção. A Rivox escolhe o adaptador com base no método, no ambiente e no número; o comerciante nunca escolhe o provedor.
Pedido
| Campo | Tipo | Obrigatório | Notas |
|---|---|---|---|
| payment_method.type | string | Sim | card, mpesa, emola ou mkesh. |
| payment_method.phone | string | Mobile money | Número do cliente; normalizado para E.164. |
| payment_method.token | string | Cartão | Token do instrumento recolhido no checkout. |
| receipt_email | string | Não | Email do cliente para recibo. |
curl -X POST https://api.rivox.co.mz/v1/payment_intents/pi_rvx_01J.../confirm \
-H "Authorization: Bearer sk_test_..." \
-H "Content-Type: application/json" \
-H "Idempotency-Key: pi-2026-000148-confirm" \
-d '{
"payment_method": { "type": "mpesa", "phone": "+258841234567" }
}'Eventos e erros
- Eventos emitidos:
payment_intent.processing,payment_intent.succeededoupayment_intent.failed, conforme o resultado. - Erros:
payment_intent_not_found,invalid_payment_method,invalid_phone,missing_token,provider_unavailable,intent_canceled. - Confirmar uma intenção já concluída devolve a mesma intenção, sem nova cobrança.
- Escalão de rate limit: financeiro.
Idempotência obrigatória na prática
Envie sempreIdempotency-Key. Numa repetição com o mesmo corpo, a Rivox devolve o mesmo resultado em vez de cobrar duas vezes.