Skip to main content

Deposit reversal

TCash system allows reversal of the deposit for a limited period after it was executed. As with the deposit itself, the reversal is done in two steps.

  1. Validation
  2. The actual reversal

Deposit reversal validation​

Before the actual reversal, if the external system provides this API call, TCash can first validate the reversal.

It is not possible to make a partial reversal, only the full amount can be reversed. The reversal is considered a new transaction and the API call contains the original transaction uuid:

  • uuid, string - The uuid of the new transaction
  • original_transaction_uuid, string - The uuid of the original transaction to be reversed

Example of the API call to validate the deposit reversal:

POST {{vendor-api-url}}/deposit-reversal-validation
Headers: {
"secret": "S6WvLB298m1#"
}
Body: {
"uuid": "5177b144-534a-4a46-95c7-4130ae1804b5",
"original_transaction_uuid": "27ac82f0-6c3b-4bc3-81e9-e16daac90e6f"
}

Deposit reversal​

After the successful reversal validation, the reversal is then pushed to the queue and processed separately. Just like the validation, the deposit API call contains two parameters:

  • UUID, string - The UUID of the new transaction
  • original_transaction_uuid, string - The UUID of the original transaction to be reversed

Example of the API call to reverse the deposit:

POST {{vendor-api-url}}/deposit-reversal
Headers: {
"secret": "S6WvLB298m1#"
}
Body: {
"uuid": "5177b144-534a-4a46-95c7-4130ae1804b5",
"original_transaction_uuid": "27ac82f0-6c3b-4bc3-81e9-e16daac90e6f"
}