Your postback notification for a MED case.

POST

/order/example-postback-to-med/[your_notification_url]

• Sandbox

Every time a transaction has its status changed, your system will receive a notification from ours, so that you know if transactions were paid.

We expect that your system returns to ours: status code 200. If not, we’ll retry 4 more times.

Request Body ^required

object

eventType

required

CREATED on the first notification about this object, STATUS_CHANGED on every change after it.

string

Allowed values: CREATED STATUS_CHANGED

Example

STATUS_CHANGED

objectType

required

Which object of the case this notification is about.

string

Allowed values: RECOVERY_VALUE INFRINGEMENT_NOTIFICATION REFUND_REQUEST

Example

REFUND_REQUEST

referenceId

required

Identifier of the object at the DICT. Use it on GET /public/v1/banking/med/{referenceId} to see the whole case.

string

Example

81d65e98-97c0-4b0f-b577-73625da1f9fc

accountId

required

Account this notification concerns.

string

Example

3689f050-bb58-4a33-bea8-3d98b0d683e1

status

required

Current status at the DICT. Recovery value: CREATED, TRACED, WAITING_ANALYSIS, ANALYSED, WAITING_REFUND, COMPLETED, CANCELLED. Infringement notification: OPEN, RECEIVED, ANALYSED, CANCELLED. Refund request: OPEN, ANALYSED, CANCELLED.

string

Example

ANALYSED

previousStatus

Status reported on the previous notification, when there was one.

string

Example

OPEN

endToEndId

Contested transaction. For a recovery value, the root transaction of the case.

string

Example

E33630661202609180143GE94DHEKRS2

recoveryId

Recovery value (the MED 2.0 case) this object belongs to.

string

Example

42d72e78-97c0-4b0f-b566-42514da1f9fc

reason

Reason of the infringement notification or of the refund request.

string

Example

FRAUD

type

Situation that originated the case.

string

Example

SCAM

amount

Contested amount, or amount requested on the refund request.

string

Example

1200.50

returnedAmount

Amount effectively returned to the account.

string

Example

1200.50

analysisResult

Result of the analysis made by the counterpart institution.

string

Example

FULLY_ACCEPTED

role

Side of the contested transaction the account took: PAYER when it was debited, RECEIVER when it was credited.

string

Allowed values: PAYER RECEIVER

Example

PAYER

awaitingOurAnalysis

True when the object is waiting for an analysis by this institution. Nothing is expected from you: it is informative.

boolean

occurredAt

required

When the change happened at the DICT, UTC ISO-8601.

string

Example

2026-09-18T03:20:00.000Z

Examples

RECOVERY_VALUE - CREATED

The case you opened was accepted by the DICT, which started tracing where the funds went.

{
  "eventType": "CREATED",
  "objectType": "RECOVERY_VALUE",
  "referenceId": "42d72e78-97c0-4b0f-b566-42514da1f9fc",
  "accountId": "3689f050-bb58-4a33-bea8-3d98b0d683e1",
  "status": "TRACED",
  "endToEndId": "E33630661202609180143GE94DHEKRS2",
  "recoveryId": "42d72e78-97c0-4b0f-b566-42514da1f9fc",
  "type": "SCAM",
  "role": "PAYER",
  "awaitingOurAnalysis": false,
  "occurredAt": "2026-09-18T01:45:10.008Z"
}

INFRINGEMENT_NOTIFICATION - CREATED

An infringement notification against one of your accounts, which received funds under contestation. The analysis is made by this institution, not by you.

{
  "eventType": "CREATED",
  "objectType": "INFRINGEMENT_NOTIFICATION",
  "referenceId": "91d65e98-97c0-4b0f-b577-73625da1f9fc",
  "accountId": "3689f050-bb58-4a33-bea8-3d98b0d683e1",
  "status": "OPEN",
  "endToEndId": "E04358798202508270918y6j6mt9l0pi",
  "recoveryId": "42d72e78-97c0-4b0f-b566-42514da1f9fc",
  "reason": "REFUND_REQUEST",
  "type": "SCAM",
  "amount": "1500.12",
  "role": "RECEIVER",
  "awaitingOurAnalysis": true,
  "occurredAt": "2026-09-18T02:10:00.000Z"
}

REFUND_REQUEST - STATUS_CHANGED

The counterpart analysed the refund request. “returnedAmount” is the amount effectively credited back.

{
  "eventType": "STATUS_CHANGED",
  "objectType": "REFUND_REQUEST",
  "referenceId": "81d65e98-97c0-4b0f-b577-73625da1f9fc",
  "accountId": "3689f050-bb58-4a33-bea8-3d98b0d683e1",
  "status": "ANALYSED",
  "previousStatus": "OPEN",
  "endToEndId": "E04358798202508270918y6j6mt9l0pi",
  "recoveryId": "42d72e78-97c0-4b0f-b566-42514da1f9fc",
  "reason": "FRAUD",
  "amount": "1200.50",
  "returnedAmount": "1200.50",
  "analysisResult": "FULLY_ACCEPTED",
  "role": "PAYER",
  "awaitingOurAnalysis": false,
  "occurredAt": "2026-09-18T03:20:00.000Z"
}

Responses

200

The resource was returned successfully

object

returnCode

required

The current page.

string

Example

SUCCESS