Query Payment Result

Introduction

• After created the payment token,if the merchant has not received the HitPoints payment success callback notification for a period. This API can be called to query the payment status of the order.

• The query interface supports three query parameters. If the user does not receive the callback notification of the successful recharge after the user completes the recharge on the merchant's platform, he can obtain the point card serial number from the user, and query the point card recharge result through the point card serial number.Note: The point card serial number(PIN SN) is not the card secret. HitPoints consists of a set of serial number and card secret; the card secret cannot be used to check the payment status.

API Url

​ sandbox：https://api.sandbox.hitpoints.com/v1/reload/query

​ production：https://api.hitpoints.com/v1/reload/query

Request Method

​ GET

Request Parameters

Parameter	Required	Type	Description
reference_id	Optional	string(45)	Merchant referenceId, unique orderId in merchant's system
transaction_id	Optional	string(45)	HitPoints transaction id
pin_sn	Optional	string(45)	the serial number of the pin (not Pin Secret)
random_key	Yes	string(16)	randomly set the value with random string

Response Example

{
    "data": {
        "transaction_id": 15,
        "pin_sn": "U000000010F00001",
        "currency": "CNY",
        "amount": "10.00",
        "pay_time": 1566374957,
        "reference_id": "39200872QQAXZ123",
        "merchant_id": 10003,
        "body": "标题信息",
        "detail": "",
        "attach": "\b附加信息",
        "pay_method": "web",
        "result": "success"
    },
    "code": 200,
    "message": "ok",
    "success": true
}

Response Field Description

Field	Description
code	The response code describe the request is success or not, code = 200 means success
message	The description message to the code
success	Describe the code with bool, when code = 200 , it's true, otherwise it's false

These fields below will response when code=200

Fields	Description
data	response data set
transaction_id	HitPoints transactionID，if payment is not completed, it's null
pin_sn	HitPoints Pin Sn，if payment is not completed, it's null
currency	The currency merchant's order，if merchant did not appoint the currency, it's null
amount	The order recharge amount, if the merchant did not appoint the amount, it's null
pay_time	the timestamp when user complete verify PIN Secret, if payment is not completed, it's null
reference_id	the unique orderID from merchant
merchant_id	the merchant UserId
body	The body parameter from merchant
detail	The detail parameter from merchant
attach	The attach parameter from merchant
result	the payment state：pending=waiting for pin secret verify, success=pin verify success, cancel= order was canceled, expired=payment is expired
pay_method	pay method, the payment was created from web or api

Response Header：

Fields	Description
Sign	The signature from HitPoints server
Date-GMT	The Time String for HitPoints calculate response signature

Notice: if request failed，that the code!=200, or this is no data field in response body，there will be no Sign field in response header

Fail response example：

{
    "code": 404100,
    "message": "data not found",
    "success": false
}