worldline

Documentation

Technical reversals

Technical reversal also know as " Blind reversal ", can be used to undo your last authorization operation when you are unsure of the outcome of it. This could be due to

  • Request timed out

  • Unhandled or invalid response

  • Suspected fraud etc.

It can be used regardless of message processing flow (single or dual).

Perform a technical reversal

Submit a technical reversal request with an operationId that you want to reverse/undo. It is recommended to include the reason property with an appropriate value from the list given below.

  • SUSPECTED_MALFUNCTION

  • INVALID_RESPONSE

  • TIMEOUT_WAITING_RESPONSE

  • SUSPECTED_FRAUD

Example technical reversal request

Below request (POST /processing/v1/100812/520002526/operations/ 919c831d-a3df-4d52-b12f-c54d6fbf4a41 /reverse) will reverse the operation pertaining to the id provided in the URL.

{
    "operationId": "d81c90d5-e1e7-4191-9682-5fda2d38dbad",
    "transactionTimestamp": "2024-10-11T13:21:24.547Z",
    "reason": "TIMEOUT_WAITING_RESPONSE"
}

Example technical reversal response

{
    "operationId": "d81c90d5-e1e7-4191-9682-5fda2d38dbad",
    "responseCode": "7204",
    "responseCodeDescription": "Message stored, not forwarded: referencing unknown trx",
    "responseCodeCategory": "APPROVED",
    "responder": "WORLDLINE"
}