Delete Transaction

Try to request a reverse of a previous Pull Transaction.

Optional Query Strings:

  • ?reversal (required to reverse a previous Pull Transaction)
  • ?void (required to void a previous Pull Transaction)

If you are an ISO (Independent Sales Organization), you will need to specify a SubClientID (see notes below).


URL:

https://<FQDN>/v1/clients/<ClientIDISO>/transactions/<TransactionID>?reversal
https://<FQDN>/v1/clients/<ClientIDISO>/transactions/<TransactionID>?void

Note:
ReadMe currently does not support empty query strings, so building a request interactively with query strings (ie ?reversal, ?void) is unavailable. However, works today in sandbox/production.


Request:

No Request Data or ~~Overrides Required for ISOs or ~~Optional Partial Reversal

JSON Name Value Required Default Description Choice
overrides String O
RISO
Overrides
For ISOs, please contact TabaPay Support for details on when and how to use.

Required for ISOs
currency String
3 digits
O 840 ISO 4217 Currency Number
amount String
Amount
O Partial Reversal Amount

Sample Request:

Pack your Request, the following Samples shown here are unpacked only for human readability:
Partial Reversal:

{
  "amount": "1.00"
}

Response:

Status Codes:

Status Code Description
200 OK A Request for a Reversal of the previous Transaction is successful.
207 Multi-Status One or more Failures occurred while processing the Request.

See Status Codes for other possible Status Codes that might be returned.


Response Data:

JSON Name Value Description Status Code
200 207 Other
SC Integer
3-digit code
HTTP Status Code O
EC String
1 or 8 characters
Internal Error Code O
EM String Error Message O O
status String Status
reversal object Reversal O
networkRC String
2 or 3-character code
Void
Network Response Code
O
networkRC2 String
2 or 3-character code
Refund after failed Void
Network Response Code
O

Sample Responses:

Transaction reversed:
{
  "SC": 200,
  "EC": "0",
  "status": "COMPLETED",
  "reversal":
  {
    "networkRC": "00"
  }
}

-----
Dual Message Network:
{
  "SC": 200,
  "EC": "0",
  "status": "COMPLETED",
  "reversal":
  {
    "networkRC": "21",
    "networkRC2": "00"
  }
}

Notes:

For Clients who are an ISO (Independent Sales Organization), to specify your ClientID and a SubClientID, use the underscore character ("_") to separate the two values: <ClientID>_<SubClientID> where:

  • ClientID is your unique 22-character string and
  • SubClientID is an assigned 4, 6 or 8-digit value.

You can only Delete (reverse) a Pull Transaction. A Delete is just only a request for a reversal. Dual Message Networks may cause a networkRC2 if:

  • the networkRC was non-zero.

A status of COMPLETED and either networkRC equals to 00 or networkRC2 equals to 00 means a successful request for a reversal.


We will only keep transactions accessible to the TabaPay API for approximately 120 days. This means that Delete Transaction will only work for transactions within approximately 120 days. However, we archive transactions for many years (as legally required).