Introdução

Os webhooks são a forma recomendada de conhecer o desfecho de uma cobrança. A Rivox entrega eventos assinados ao seu endpoint HTTPS depois de a operação financeira estar comprometida.

Princípios

• Um evento só é emitido depois de o estado estar persistido — nunca antes.
• Eventos de provedor são internos; o comerciante recebe apenas eventos Rivox normalizados.
• Cada evento tem um identificador imutável, prefixado por evt_.
• A entrega é assíncrona, com retentativas. O mesmo evento pode chegar mais do que uma vez.
• Endpoints têm de ser HTTPS e são isolados por conta e por ambiente.

Formato

{
  "id": "evt_rvx_01J...",
  "object": "event",
  "type": "charge.succeeded",
  "created": 1788350460,
  "livemode": false,
  "data": {
    "object": {
      "object": "charge",
      "id": "ch_rvx_01J...",
      "status": "succeeded",
      "amount": 25000,
      "currency": "MZN"
    }
  }
}