MedAccepted

Overview

The MedAccepted event is sent when the MED analysis is completed at FyPay and the refund is approved. This means the blocked amount of the original transaction is returned to the payer.

When you receive this event, the amount has been (or will be) debited from the beneficiary account and returned to the original payer. Update your financial records accordingly.

Field	Value
`event`	`MedAccepted`
Meaning	Refund approved — amount returned to payer
Recommended action	Record debit, notify beneficiary, update statement

Full Payload

{
  "event": "MedAccepted",
  "medId": 42,
  "idSolicitacaoDevolucao": "MED-2026041012345",
  "endToEndId": "E12345678202604101030abcdef123456",
  "status": "ANALYZED",
  "reason": "REFUND_REQUEST",
  "cause": "UNAUTHORIZED_TRANSACTION",
  "description": "Customer claims not to have performed the transaction",
  "analysisResult": "APPROVED",
  "analysisDetails": "Devolução aprovada pelo operador - valor devolvido",
  "originalTransaction": {
    "transactionId": 78432,
    "amount": 1500.00,
    "endToEndId": "E12345678202604101030abcdef123456",
    "externalId": "ORDER-78432"
  },
  "blockStatus": "APPROVED",
  "blockedAmount": 1500.00,
  "defenseStatus": null,
  "requestingBank": {
    "ispb": "00000000",
    "name": "BCO DO BRASIL S.A."
  },
  "contestedBank": {
    "ispb": "13140088",
    "name": "ACESSO SOLUÇÕES DE PAGAMENTO"
  },
  "statusHistory": [
    { "status": "OPEN", "date": "2026-04-10T09:55:12.000Z" },
    { "status": "RECEIVED", "date": "2026-04-10T10:00:00.000Z" },
    { "status": "ANALYZED", "date": "2026-04-12T15:30:00.000Z" }
  ],
  "createdAt": "2026-04-10T10:00:00.000Z",
  "updatedAt": "2026-04-12T15:30:00.000Z"
}

Relevant fields in this event

Field	Expected value	Description
`status`	`"ANALYZED"`	MED analyzed
`analysisResult`	`"APPROVED"`	Refund approved
`analysisDetails`	string	Rationale for approval
`blockStatus`	`"APPROVED"`	Blocked balance approved for refund
`blockedAmount`	number \| null	Amount that was blocked and has been refunded (in BRL)
`statusHistory`	array	History of MED status transitions
`statusHistory[].status`	string	Status at that moment (same values as `status`)
`statusHistory[].date`	string	Transition date (ISO 8601)

Next Steps

MedCreated

Initial MED creation event

MedRejected

Event when the refund is rejected

MED Overview

Understand the full lifecycle