Payload Pay-In

`payin.completed`

{
  "eventType": "payin.completed",
  "txId": "a1b2c3d4e5f6",
  "type": "PAYIN",
  "status": "COMPLETED",
  "amount": 10000,
  "currency": "BRL",
  "feeCharged": 300,
  "netAmount": 9700,
  "e2eId": "E12345678202603241400000000001",
  "updatedAt": "2026-03-24T14:02:30.000Z",
  "debtor": {
    "document": "123.456.789-00",
    "name": "João Silva",
    "accountType": "CHECKING",
    "ispb": "60701190",
    "branch": "0001",
    "account": "12345-6"
  },
  "creditor": {
    "document": "11.222.333/0001-44",
    "name": "Acme Corp",
    "accountType": "PAYMENT",
    "ispb": "18236120",
    "branch": "0001",
    "account": "98765-4"
  }
}

`payin.failed`

{
  "eventType": "payin.failed",
  "txId": "a1b2c3d4e5f6",
  "type": "PAYIN",
  "status": "FAILED",
  "amount": 10000,
  "currency": "BRL",
  "feeCharged": 0,
  "netAmount": 0,
  "e2eId": null,
  "updatedAt": "2026-03-24T14:05:00.000Z"
}

`payin.reversed`

{
  "eventType": "payin.reversed",
  "txId": "reversal-txid-xyz",
  "type": "PAYIN",
  "status": "REVERSED",
  "amount": 10000,
  "currency": "BRL",
  "feeCharged": 250,
  "reason": "customerRequest",
  "e2eId": "E12345678202603241415000000001",
  "reversedAt": "2026-03-24T14:15:00.000Z",
  "debtor": {
    "document": "123.456.789-00",
    "name": "João Silva",
    "accountType": "CHECKING",
    "ispb": "60701190",
    "branch": "0001",
    "account": "12345-6"
  },
  "creditor": {
    "document": "11.222.333/0001-44",
    "name": "Acme Corp",
    "accountType": "PAYMENT",
    "ispb": "18236120",
    "branch": "0001",
    "account": "98765-4"
  },
  "metadata": {
    "reason": "customerRequest",
    "triggerTransactionId": "E12345678202603241400000000001"
  }
}

Campos comunes

Campo	Descripción
`eventType`	Nombre del evento (`payin.completed`, `payin.failed`, `payin.reversed`)
`txId`	ID de la transacción en Rivopay
`type`	Siempre `PAYIN`
`status`	Estado: `COMPLETED`, `FAILED`, `REVERSED`
`amount`	Monto en centavos
`feeCharged`	Fee cobrado en centavos (`0` si el pago falló)
`netAmount`	Monto neto acreditado en tu balance (solo en `completed`)
`e2eId`	ID de extremo a extremo del sistema PIX (`null` si falló)
`debtor`	Datos del pagador — disponible en `completed` y `reversed`
`creditor`	Datos del beneficiario (tu cuenta) — disponible en `completed` y `reversed`
`reason`	Motivo del reverso (solo en `reversed`)
`reversedAt`	Timestamp del reverso (solo en `reversed`)
`metadata.triggerTransactionId`	`e2eId` de la transacción original que disparó el reverso