Real Time Transaction Query (RTTQ)

The Real Time Transaction Query (RTTQ) service is a web service that provides a mechanism for merchants to retrieve the status of a transaction.

Setting up RTTQ

In order to set up RTTQ, merchants will need the following information:

• Authentication: RTTQ uses the same client certificate for authentication as the payment gateway web service (see API authentication)
• Base URL: "https://*.ecentricpaymentgateway.co.za"
• URL suffix: "apirttq"
• URL scheme: "HTTPS"
• User authorization: "none"

Format:

• JSON
• Headers:
  • Content-Type = “application/json“
  • Accept = “application/json”
• Request type:
  GET "/query/Merchant/{{MerchantID}}/?TransactionId={{TransactionId}}&OrderNumber={{OrderNumber}}"
• Template parameter: "{{MerchantID}}" is required
• Query parameters: "{{TransactionId}}" or "{{OrderNumber}}" where either of these is required
  MerchantID – uniquely identifies a merchant (also known as the merchant GUID)
  TransactionID - the unique transaction ID of the transaction being queried
  OrderNumber - the unique order number or reference of the transaction being queried

Response sample for 3D secure processing

[
            {
                "Amount":"200",
                "AuthCode":"",
                "CardAcceptorID":"000000002099853",
                "CurrencyCode":"710",
                "MaskedCardNumber":"403822******3018",
                "MerchantID":"B64622BE-4C90-4246-A42F-9E3AE99C1D96",
                "OrderNumber":"MR82235338",
                "PaymentService":"CardNotPresent",
                "ReconID":"MR82235338-CNP",
                "RequestType":"Payment",
                "ResponseCode":"6",
                "ResponseSource":"3DSecure",
                "RetrievalReferenceNumber":"00MR82235338",
                "SaleReconID":"MR82235338",
                "SystemsTraceAuditNumber":"315921",
                "TransactionDateTime":"2022-11-16T21:59:48",
                "TransactionID":"36A605B9-6869-45A4-ABEA-E9A9FAD84859",
                "TransactionStatus":"Processing"
            }
]

Response sample for a successful transaction.

[
            {
                "Amount":"200",
                "AuthCode":"123456",
                "CardAcceptorID":"000000002099853",
                "CurrencyCode":"710",
                "MaskedCardNumber":"403822******3018",
                "MerchantID":"B64622BE-4C90-4246-A42F-9E3AE99C1D96",
                "OrderNumber":"MR82235338",
                "PaymentService":"CardNotPresent",
                "ReconID":"MR82235338-CNP",
                "RequestType":"Payment",
                "ResponseCode":"00",
                "ResponseSource":"Acquirer",
                "RetrievalReferenceNumber":"00MR82235338",
                "SaleReconID":"MR82235338",
                "SystemsTraceAuditNumber":"315921",
                "TransactionDateTime":"2022-11-16T21:59:48",
                "TransactionID":"36A605B9-6869-45A4-ABEA-E9A9FAD84859",
                "TransactionStatus":"Success"
            }
]