POST payments/credit/reversal

Reverses (cancels) any payment transaction that is still within an open batch.

Request Information

URI Parameters

None.

Body Parameters

request payload

ReversalRequest
NameDescriptionTypeAdditional information
TransactionData

Specific information for the transaction.

ReversalTransactionData

Required

OriginalTransactionData

Specific information for the original transaction (to be reversed).

ReversalOriginalTranData

Required

EmvTransactionData

Specific information to reverse and EMV transaction.

ReversalEmvTransactionData

None.

Request Formats

application/json, text/json

Sample:
{
  "TransactionData": {
    "UniqueIdentifier": "sample string 1",
    "TimeStamp": "2024-04-20T07:09:01.235Z",
    "DeviceRegistrationIdentifier": "436299e2-c8c2-4081-a8e8-a94d8a085f67"
  },
  "OriginalTransactionData": {
    "HostTransactionID": 1
  },
  "EmvTransactionData": {
    "ReasonType": "Canceled",
    "EMVCardData": {
      "Reader": "sample string 1",
      "ReaderSerialNumber": "sample string 2",
      "ReaderKernelHash": "sample string 3",
      "ReaderConfigurationVersion": "sample string 4",
      "ReaderEncoding": "None",
      "TlvEncrypted": "sample string 5",
      "Tlv": "sample string 6",
      "KeySerialNumber": "sample string 7"
    }
  }
}

Response Information

Resource Description

Reverses (cancels) any payment transaction that is still within an open batch.

ReversalResponse
NameDescriptionTypeAdditional information
TransactionRequestData

Transaction request data, such as echo back properties.

PaymentTransactionRequestData

Required

Result

Transaction result, such as success or failure.

PaymentTransactionResult

Required

Response Formats

application/json, text/json

Sample:
{
  "TransactionRequestData": {
    "UniqueIdentifier": "sample string 1"
  },
  "Result": {
    "ProcessorResponseCode": "sample string 1",
    "ProcessorResponseText": "sample string 2",
    "ResponseCode": 3,
    "ResponseText": "sample string 4"
  }
}