Inquiry

Verify a Slip Status#

GET /enqStatus

Returns details for a PromptPay/PayNow transaction. Request will eventually be sending to respective acquirer party to check status.

Parameters#

Request Body
Example

Name	Type	Required	Description
merchantID	string(50)	false	Unique Merchant ID set by the company
terminalID	string(25)	false	Unique ID of the terminal
amount	string(13)	true	Transaction amount. Amount should always contain two decimal points i.e. Amount "100.00" is defined as "100.00", Amount "99.12" is defined as "99.12"
qRCodeID	string(20)	true	Unique identifier of QR code
checkSum	string	true	Checksum of the query string

Example response:#

{
  "responseCode": "000",
  "responseDesc": "Success",
  "transactionID": "12389",
  "transactionDate": "20180124 21:32:46",
  "checksum": "94E8E91C29E73B9648011FADBAE19849B520B24B"
}

Get a Payment Status#

GET /paymentStatus

Returns details for a payment transaction. Typically, this method is used by merchants to get the status and details of the payment after receiving a payment status notification from QR Gateway. The method can be requested by providing a Transaction ID.

Parameters#

Request Body
Example

Name	Type	Required	Description
transactionID	integer(int64)	true	Unique transaction ID generated by QRGW
checkSum	string	true	Checksum of the query string

Example responses:#

{
  "responseCode": "000",
  "transactionID": "1234",
  "merchantID": "10001",
  "terminalID": "T1001",
  "channelName": "VISA",
  "channelCode": "VSA",
  "originalAmount": "500.00",
  "transactionCurrency": "764",
  "merchantAmount": "500.00",
  "merchantFee": "2.00",
  "merchantVAT": "0.14",
  "merchantNetAmount": "497.86",
  "merchantCurrency": "764",
  "transactionDate": "20171110 12:30:22",
  "invoice": "1234",
  "note": "",
  "payerAccountNumber": "123456XXXXXX1245",
  "statusCode": "S",
  "userDefined": "ABC1234",
  "approvalCode": "AA1234",
  "qrCodeID": 112345,
  "checksum": "94E8E91C29E73B9648011FADBAE19849B520B24B"
}

Get a Refund Status#

GET /refundStatus

Returns details for a refund transaction. Typically, this method is used by merchants to get the status and details of the refund after receiving a refund status notification from QR Gateway. The method can be requested by providing either Refund Transaction ID or Refund Reference ID.

Parameters#

Request Body
Example

Name	Type	Required	Description
refundReferenceID	string(20)	conditional	Unique reference provided during refund
refundTransactionID	string(20)	conditional	Unique transaction ID generated by QRGW
checkSum	string	true	Checksum of the query string

Example responses:#

{
{
    "responseCode": "000",
    "refundTransactionID": 12345677,
    "refundReferenceID": "",
    "refundStatus": "RS",
    "refundStatusMessage": "Refund Settled",
    "channelName": "VISA",
    "channelCode": "VSA",
    "refundCurrency": "764",
    "refundAmount": "500.00",
    "refundFee": "0.00",
    "refundApprovalCode": "AA1235",
    "requestDate": "20171111 12:30:22",
    "refundDate": "20171112 18:20:55",
    "transactionID": 1234,
    "merchantID": "10001",
    "terminalID": "T1001",
    "originalAmount": "500.00",
    "transactionCurrency": "764",
    "merchantPAN": "5204730000000013",
    "merchantAmount": "500.00",
    "merchantFee": "2.00",
    "merchantVAT": "0.14",
    "merchantNetAmount": "497.86",
    "merchantCurrency": "764",
    "transactionDate": "20171110 12:30:22",
    "invoice": "1234",
    "note": "",
    "payerAccountNumber": "123456XXXXXX1245",
    "payerName": "Alice",
    "statusCode": "S",
    "userDefined": "ABC1234",
    "approvalCode": "AA1234",
    "qrCodeID": "115485",
    "checksum": "94E8E91C29E73B9648011FADBAE19849B520B24B"
}
}