When you trigger a transaction, a communication or technical issue can prevent your ECR from receiving a response from the terminal. Without this response it is unclear if the transaction has been processed successfully or not.
In such situation, cashier may try to cancel or refund the transaction, or repeat the transaction. Instead, your integration should request the transaction's status to know the transaction status.
We recommend that your integration automatically checks the status of a transaction any time it fails to receive a transaction response.
Payment requests time out after a while. If you do not receive a payment response (or you receive a response indicating a time-out) after 120 seconds TransactionStatusand the internet connection hasn't dropped, your integration should automatically check the transaction status.
Perform Transaction Status
Request MessageHeader
Elements | Required | Description |
|---|---|---|
ProtocolVersion |
| 3.1 |
MessageClass |
| Service |
MessageCategory |
| TransactionStatus |
MessageType |
| Request |
ServiceID |
| Your unique ID for this request, consisting of 1-10 alphanumeric characters. Must be unique within the last 48 hours for the terminal (POIID) 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 |
|---|---|---|---|
TransactionStatusRequest |
Example of SaleToPOIRequest
<?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="TransactionStatus" MessageType="Request" ServiceID="3911" SaleID="ECR001" POIID="456"></MessageHeader>
<TransactionStatusRequest></TransactionStatusRequest>
</SaleToPOIRequest>Receive SaleToPOIResponse
Example of SaleToPOIResponse
<SaleToPOIResponse>
<MessageHeader MessageCategory="TransactionStatus" MessageClass="Service" MessageType="Response" POIID="456" ProtocolVersion="3.1" SaleID="ECR001" ServiceID="3911"/>
<TransactionStatusResponse>
<RepeatedMessageResponse>
<MessageHeader MessageCategory="Payment" MessageClass="Service" MessageType="Response" POIID="456" ProtocolVersion="3.1" SaleID="ECR001" ServiceID="3910"/>
<PaymentResponse>
<MarketpayPaymentExtensions ApplicationID="A0000000041010" BankID="513640" PANSequenceNumber="01"/>
<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 01</OutputText>
<OutputText EndOfLineFlag="true">AID: A0000000041010</OutputText>
<OutputText EndOfLineFlag="true">CARD TYPE: MASTERCARD</OutputText>
<OutputText EndOfLineFlag="true">PAYMENT</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">TIME: 13:40:44</OutputText>
<OutputText EndOfLineFlag="true">DATE: 29.03.2025</OutputText>
<OutputText EndOfLineFlag="true">AUTHENTICATION METHOD: NO</OutputText>
<OutputText EndOfLineFlag="true">CARDHOLDER VERIFICATION</OutputText>
<OutputText EndOfLineFlag="true">PLEASE RETAIN FOR YOUR RECORDS</OutputText>
</OutputContent>
</PaymentReceipt>
<PaymentReceipt DocumentQualifier="CustomerReceipt" RequiredSignatureFlag="false">
<OutputContent OutputFormat="Text">
<OutputText EndOfLineFlag="true">RECU PORTEUR</OutputText>
<OutputText EndOfLineFlag="true">--------------------------------</OutputText>
<OutputText EndOfLineFlag="true">Candy Shop</OutputText>
<OutputText EndOfLineFlag="true">75002 Paris</OutputText>
<OutputText EndOfLineFlag="true">RÉFÉRENCE: 2</OutputText>
<OutputText EndOfLineFlag="true">TID: 30010910</OutputText>
<OutputText EndOfLineFlag="true">NOM DE L'APPAREIL: 1760317010</OutputText>
<OutputText EndOfLineFlag="true">MARCHAND: 000000001231344</OutputText>
<OutputText EndOfLineFlag="true">PAN: XXXXXXXXXXXX7462 01</OutputText>
<OutputText EndOfLineFlag="true">AID: A0000000041010</OutputText>
<OutputText EndOfLineFlag="true">TYPE DE CARTE: MASTERCARD</OutputText>
<OutputText EndOfLineFlag="true">PAIEMENT</OutputText>
<OutputText EndOfLineFlag="true">SANS CONTACT</OutputText>
<OutputText EndOfLineFlag="true">MONTANT:€ 10,02</OutputText>
<OutputText EndOfLineFlag="true">Approuvé</OutputText>
<OutputText EndOfLineFlag="true">213462</OutputText>
<OutputText EndOfLineFlag="true">TIME: 13:40:44</OutputText>
<OutputText EndOfLineFlag="true">DATE: 29.03.2025</OutputText>
<OutputText EndOfLineFlag="true">METHODE</OutputText>
<OutputText EndOfLineFlag="true">D'AUTHENTIFICATION: AUCUNE</OutputText>
<OutputText EndOfLineFlag="true">VÉRIFICATION DU TITULAIRE DE LA</OutputText>
<OutputText EndOfLineFlag="true">CARTE</OutputText>
<OutputText EndOfLineFlag="true">VEUILLEZ CONSERVER POUR VOS</OutputText>
<OutputText EndOfLineFlag="true">DOSSIERS</OutputText>
</OutputContent>
</PaymentReceipt>
<PaymentResult MerchantOverrideFlag="false" OnlineFlag="true">
<AmountsResp AuthorizedAmount="10.02" Currency="EUR"/>
<PaymentAcquirerData AcquirerID="40105611508" AcquirerPOIID="30010910" MerchantID="000000001231344">
<ApprovalCode>213462</ApprovalCode>
</PaymentAcquirerData>
<PaymentInstrumentData PaymentInstrumentType="Card">
<CardData EntryMode="Contactless" MaskedPAN="XXXXXXXXXXXX7462" PaymentBrand="MASTERCARD"/>
</PaymentInstrumentData>
</PaymentResult>
<POIData>
<POITransactionID TimeStamp="2025-03-29T13:40:52.754" TransactionID="2"/>
</POIData>
<Response Result="Success">
<AdditionalResponse>000</AdditionalResponse>
</Response>
<SaleData OperatorID="666">
<SaleTransactionID TimeStamp="2025-03-29T12:40:47Z" TransactionID="123"/>
</SaleData>
</PaymentResponse>
</RepeatedMessageResponse>
<Response Result="Success"/>
</TransactionStatusResponse>
</SaleToPOIResponse>