This method allows authorized terminals to revert a previously completed prepaid top-up transaction, restoring the credited amount back to the system’s available balance.Use this endpoint to:
Cancel a prepaid transaction that was already processed.
Return the funds to the originating balance.
Handle product-specific reversion logic.
Reversion is subject to product-specific constraints:
Some products do not allow reversion under any circumstances.
Others may allow it only within a limited time frame after the original transaction.
To ensure a successful reversal, all required parameters—such as timestamps and local reference—must match the original top-up. If the product or time window conditions are not met, the operation will return a corresponding error message.
Request
Path Params
terminalId
integer<int32>
required
operatorId
integer<int32>
required
localReference
integer<int32>
required
This localReference in the path parameters refers to the revert request itself, not the original transaction. To identify the transaction being reverted, use the field originalLocalReference inside the request body
Header Params
U
string
required
Default:
{{U}}
SH
string
required
Default:
{{SH}}
ST
string
required
Default:
{{ST}}
Body Params application/json
amountToSendX100
integer<int32>
required
localDateTime
string<date-time>
required
This field represents the timestamp of the revert transaction itself**, not the original top-up. It should reflect the exact date and time when the reversal request is initiated, formatted in ISO 8601.
account
string
required
This field must contain the exact account identifier used in the original transaction.
originalLocalReference
integer<int32>
required
This field must contain the exact local reference of the original transaction that is being reverted.
originalLocalDate
string<date-time>
required
This timestamp must reflect the exact date and time when the original transaction took place (in ISO 8601 format).
