PayEase Order Query Interface

Description

Merchant use single order query interface to query order status on PayEase platform and through the active query order to learn the order information.

Request Endpoint

https://apis.5upay.com/icc/orderQuery

Name Type& Max Description Requirement
merchantId varchar(9) The unique identity of the merchant ID in Payease system, After the merchant completes Payease system registration, the merchant can log in the merchant background to check M
requestId varchar(80) Format is date(yyyymmdd)-merchant id-merchant flow number e.g.: 20170101-888-12345 The flow number is numeric, not repeated within 24 hours and only be number and “-”. It can be single or multiple. M
hmac varchar(500) The method for obtaining hmac is shown in "Developers," The parameter sequence is spliced from A-Z with the initials of key name, and The corresponding key values are separated by #. M

The preceding parameter values cannot contain the following special characters: ’”&<>()

Sample

{ "merchantId": "888", "requestId": "20190813-888-123456", "hmac": "af291df5d288690d2b7d7bcff7dc5a74447ce1502c1edcc9293051bb6a517d68 6fbb31de72bfd14938d474fa6dd0afb82a2c222a6a345e41683d456a142e3376 c5c8f07dc5bc92dd5b09af316fa478a003189ed4d4c956d33162de11a8aec8ab 6abcf66b19833302780cffaa25c7e40bb9b2ccc59adc44e3fcb4632bce5d9cf9" }

Response Fields

Note: Only when the response processing is normal, the status parameter value is SUCCESS, the message includes merchant number, order number and other information.

Name Description
status SUCCESS
ERROR Refer to ERROR LIST
pstatus Payment status: INIT
SUCCESS
FAILED
PROCESSING
pstatusDescription See the table "payment status code"
merchantId Same as the merchantId of the request parameter
paymentModeAlias The return value is VISA MASTER AE JCB
requestId Same as the requestId of the request parameter
serialNumber Payease System transaction serial number
bankNumber Bank order ID
orderCurrency CNY is RMB, USD is US dollar, EUR is Euro, GBP is pound, JPY is yen, KRW is Korean dollar, RUB is rouble, CHF is Swiss franc, HKD is Hong Kong dollar, SGD is Singapore dollar, MOP is Macao dollar, CAD is Canadian dollars, NZD is New Zealand dollars, TWD is nt dollars, AUD is Australian dollars
orderAmount Same as the order amount of the request parameter
submissionTime Format: yyyy-MM-dd HH:mm:ss
completeTime Format: yyyy-MM-dd HH:mm:ss
totalRefundCount Count of Refund
totalRefundAmount Total amount of refund
refundDetails Please refer to the table "Response Fields (refundDetails)" below
totalRefuseCount Count of Refuse
totalRefuseAmount Total amount of refuse
refuseDetails Please refer to the table "Response Fields (refuseDetails)" below
remark Same as the remark of the request parameter
hmac The method for obtaining hmac is shown in "Developers," The parameter sequence is spliced from A-Z with the initials of key name, and The corresponding key values are separated by #.

Response Fields (refundDetails)

Name Description
status INIT
SUCCESS
FAILED
PROCESSING
refundId Refund ID
requestId Same as the requestId of the request parameter
bankNumber Refund bank number
refundAmount Refund Amount
refundSubmissionTime Format: yyyy-MM-dd HH:mm:ss
refundCompleteTime Format: yyyy-MM-dd HH:mm:ss

Response Fields (refuseDetails)

Name Description
refuseId Refuse ID
bankNumber Refuse bank number
refuseAmount Refuse Amount
refuseCompleteTime Format: yyyy-MM-dd HH:mm:ss

Sample

{ "status": "SUCCESS", "pstatus": "SUCCESS", "statusDescription": "0000", "merchantId": "888", "paymentModeAlias": "MASTER", " requestId": "20190813-888-123456", "serialNumber": "123456", "bankNumber": "3456789098", "orderCurrency": "CNY", "orderAmount": "1.00", "submissionTime": "2019-08-13 01:12:30", "completeTime": "2019-08-13 01:12:31", "totalRefundCount": "1", "totalRefundAmount": "10.00", "refundDetails": [ { "status": "SUCCESS", "refundId": "816290053119947", "requestId": "12345", "bankNumber": "345678", "refundAmount": "1.00", "refundSubmissionTime": "2019-08-13 21:30:00", "refundCompleteTime ": "2019-08-13 21:30:01", }, ], "totalRefuseCount": "1", "totalRefuseAmount": "10.00", "refuseDetails": [ { "refuseId": "34567878", "bankNumber": "25657890", "refuseAmount": "1.00", "refuseCompleteTime": "2019-08-13 21:30:02", }, ], "remark": "test", "hmac": " af291df5d288690d2b7d7bcff7dc5a74447ce1502c1edcc9293051bb6a517d68 6fbb31de72bfd14938d474fa6dd0afb82a2c222a6a345e41683d456a142e3376 c5c8f07dc5bc92dd5b09af316fa478a003189ed4d4c956d33162de11a8aec8ab 6abcf66b19833302780cffaa25c7e40bb9b2ccc59adc44e3fcb4632bce5d9cf9", }