docs
Webhooks

MedRejected

Overview

The MedRejected event is sent when the MED analysis is completed at FyPay and the refund is rejected. This means the amount remains with the beneficiary and the balance that was blocked is released.

When you receive this event, any previously blocked balance is automatically unblocked. The amount remains with the beneficiary and no debit is performed.

FieldValue
eventMedRejected
MeaningRefund denied — amount kept with beneficiary
Recommended actionUnblock beneficiary, notify that the amount was kept

Full Payload

{
  "event": "MedRejected",
  "medId": 43,
  "idSolicitacaoDevolucao": "MED-2026041067890",
  "endToEndId": "E98765432202604101530fedcba654321",
  "status": "ANALYZED",
  "reason": "REFUND_REQUEST",
  "cause": null,
  "description": "I believed I was making an investment",
  "analysisResult": "REJECTED",
  "analysisDetails": "Devolução rejeitada pelo operador - saldo desbloqueado",
  "originalTransaction": {
    "transactionId": 99012,
    "amount": 500.00,
    "endToEndId": "E98765432202604101530fedcba654321",
    "externalId": "SALE-99012"
  },
  "blockStatus": "UNBLOCKED",
  "blockedAmount": 500.00,
  "defenseStatus": "SUBMITTED",
  "requestingBank": {
    "ispb": "60701190",
    "name": "ITAÚ UNIBANCO S.A."
  },
  "contestedBank": {
    "ispb": "13140088",
    "name": "ACESSO SOLUÇÕES DE PAGAMENTO"
  },
  "statusHistory": [
    { "status": "OPEN", "date": "2026-04-08T08:55:00.000Z" },
    { "status": "RECEIVED", "date": "2026-04-08T09:00:00.000Z" },
    { "status": "ANALYZED", "date": "2026-04-13T11:45:00.000Z" }
  ],
  "createdAt": "2026-04-08T09:00:00.000Z",
  "updatedAt": "2026-04-13T11:45:00.000Z"
}

Relevant fields in this event

FieldExpected valueDescription
status"ANALYZED"MED analyzed
analysisResult"REJECTED"Refund denied
analysisDetailsstringRationale for rejection
blockStatus"UNBLOCKED"Previously blocked balance was released
blockedAmountnumberAmount that was blocked and has been released (in BRL)
defenseStatus"SUBMITTED" | nullWhether a defense was submitted
statusHistoryarrayHistory of MED status transitions
statusHistory[].statusstringStatus at that moment (same values as status)
statusHistory[].datestringTransition date (ISO 8601)

Next Steps

On this page