This function performs a Cancellation of the original transaction. A cancellation can be requested from the ECR to reverse a transaction and return the funds back to the client.
This request may come from a technical problem (time out on ECR or terminal side) if case where there is no response from Market Pay server.
Your title goes here
You can find out the difference between a refund and a cancellation in our User Guide.
Parameters required to cancel payment transaction.
Request MessageHeader
Elements | Required | Description |
|---|---|---|
ProtocolVersion |
| 3.1 |
MessageClass |
| Service |
MessageCategory |
| Reversal |
MessageType |
| Request |
ServiceID |
| unique identification of a message pair consisting of 1-10 alphanumeric characters. Must be unique within the last 24 hours for the terminal being used. |
SaleID |
| identifier of the ECR initiating the request (e.g., ECR001) |
POIID |
| identifier of the Terminal receiving the request (e.g., 456) |
Request body
Elements | Attributes | Required | Description |
|---|---|---|---|
ReversalRequest | |||
SaleData | |||
OperatorID |
| identifier for the operator performing the transaction for the ECR | |
SaleTransactionID | |||
TransactionID |
| unique reference to identify a payment. In the Hub, this will show as “Store transaction ID” in transaction details | |
TimeStamp |
| date and time of the request in UTC ISO format, e.g., 2025-03-03T10:39:59Z | |
OriginalPOITransaction | |||
POITransactionID | |||
TransactionID |
| Transaction identifier of the original payment received in Element <POIData> under attribute “TransactionID” | |
Timestamp |
| date and time of the request in UTC ISO format, e.g., 2025-03-03T10:39:59Z | |
CustomerOrder | |||
StartDate |
| date and time of the request in UTC ISO format, e.g., 2025-03-03T10:39:59Z | |
Cancel request message
<?xml version="1.0" encoding="UTF-8"?>
<SaleToPOIRequest xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<MessageHeader MessageClass="Service" MessageCategory="Reversal" MessageType="Request" ServiceID="3913" SaleID="ECR001" POIID="456"></MessageHeader>
<ReversalRequest ReversalReason="MerchantCancel" ReversedAmount="10.02">
<SaleData OperatorID="666">
<SaleTransactionID TransactionID="123" TimeStamp="1970-01-01T00:00:00Z"></SaleTransactionID>
</SaleData>
<OriginalPOITransaction LastTransactionFlag="false">
<POITransactionID TransactionID="2" TimeStamp="1970-01-01T00:00:00Z"></POITransactionID>
</OriginalPOITransaction>
<CustomerOrder StartDate="2025-03-29T12:41:46Z" ForecastedAmount="10.02" Currency="EUR"></CustomerOrder>
<MarketpayPaymentExtensions></MarketpayPaymentExtensions>
</ReversalRequest>
</SaleToPOIRequest>Cancel request response
<SaleToPOIResponse>
<MessageHeader MessageCategory="Reversal" MessageClass="Service" MessageType="Response" POIID="456" ProtocolVersion="3.1" SaleID="ECR001" ServiceID="3913"/>
<ReversalResponse>
<PaymentReceipt DocumentQualifier="CashierReceipt" RequiredSignatureFlag="false">
<OutputContent OutputFormat="Text">
<OutputText EndOfLineFlag="true">MERCHANT RECEIPT</OutputText>
<OutputText EndOfLineFlag="true">--------------------------------</OutputText>
<OutputText EndOfLineFlag="true">Candy Shop</OutputText>
<OutputText EndOfLineFlag="true">75002 Paris</OutputText>
<OutputText EndOfLineFlag="true">REFERENCE: 2</OutputText>
<OutputText EndOfLineFlag="true">TID: 30010910</OutputText>
<OutputText EndOfLineFlag="true">DEVICE NAME: 1760317010</OutputText>
<OutputText EndOfLineFlag="true">MERCHANT: 000000001231344</OutputText>
<OutputText EndOfLineFlag="true">PAN: XXXXXXXXXXXX7462</OutputText>
<OutputText EndOfLineFlag="true">AID: A0000000041010</OutputText>
<OutputText EndOfLineFlag="true">CARD TYPE: MASTERCARD</OutputText>
<OutputText EndOfLineFlag="true">CANCELLATION</OutputText>
<OutputText EndOfLineFlag="true">CONTACTLESS</OutputText>
<OutputText EndOfLineFlag="true">AMOUNT:€ 10,02</OutputText>
<OutputText EndOfLineFlag="true">Approved</OutputText>
<OutputText EndOfLineFlag="true">213462</OutputText>
<OutputText EndOfLineFlag="true">PLEASE RETAIN FOR YOUR RECORDS</OutputText>
</OutputContent>
</PaymentReceipt>
<PaymentReceipt DocumentQualifier="CustomerReceipt" RequiredSignatureFlag="false">
<OutputContent OutputFormat="Text">
<OutputText EndOfLineFlag="true">CARDHOLDER RECEIPT</OutputText>
<OutputText EndOfLineFlag="true">--------------------------------</OutputText>
<OutputText EndOfLineFlag="true">Candy Shop</OutputText>
<OutputText EndOfLineFlag="true">75002 Paris</OutputText>
<OutputText EndOfLineFlag="true">REFERENCE: 2</OutputText>
<OutputText EndOfLineFlag="true">TID: 30010910</OutputText>
<OutputText EndOfLineFlag="true">DEVICE NAME: 1760317010</OutputText>
<OutputText EndOfLineFlag="true">MERCHANT: 000000001231344</OutputText>
<OutputText EndOfLineFlag="true">PAN: XXXXXXXXXXXX7462</OutputText>
<OutputText EndOfLineFlag="true">AID: A0000000041010</OutputText>
<OutputText EndOfLineFlag="true">CARD TYPE: MASTERCARD</OutputText>
<OutputText EndOfLineFlag="true">CANCELLATION</OutputText>
<OutputText EndOfLineFlag="true">CONTACTLESS</OutputText>
<OutputText EndOfLineFlag="true">AMOUNT:€ 10,02</OutputText>
<OutputText EndOfLineFlag="true">Approved</OutputText>
<OutputText EndOfLineFlag="true">213462</OutputText>
<OutputText EndOfLineFlag="true">PLEASE RETAIN FOR YOUR RECORDS</OutputText>
</OutputContent>
</PaymentReceipt>
<POIData>
<POITransactionID TimeStamp="2025-03-29T13:40:44.374" TransactionID="2"/>
</POIData>
<Response Result="Success"/>
</ReversalResponse>
</SaleToPOIResponse>