Request
Less than 1 minute
HTTP Request
Service Code | 92 |
---|---|
Name | API Inquiry Status |
Version | v2.0 |
HTTP Method | POST |
Path | {Base URL}/v2.0/inquiry-status |
Header Parameters
Area | Field | Attribute | Type | Description |
---|---|---|---|---|
Header | Content-Type | M | String | application/json |
X-TIMESTAMP | M | String | yyyy-MM-ddTHH:mm:ss[zoneOffset] eg: 2020-12-17T10:55:00+07:00 | |
X-SIGNATURE | M | String | signature | |
X-PARTNER-ID | M | String | merchant ID |
Tips
X-SIGNATURE = SHA256withRSA(private_key, stringToSign)
private_key
is merchant rsa private keystringToSign = X-TIMESTAMP + "|" + merchant_secret + "|" + minify(requestBody)
minify(requestBody)
is convert the request parameters to JSON string, and then remove line breaks, spaces, and other escape characters- we provide some development languages
minify
andSHA256withRSA
demo. please refer to signature
Body Parameters
Area | Field | Attribute | Type | Description |
---|---|---|---|---|
Body | tradeType | M | number | Trade Type |
orderNo | C | String(32) | merchant transaction Unique ID | |
tradeNo | C | String(32) | smilepayz transaction Unique ID |
Info
At least one of tradeNo and orderNo is not empty
Example Body – inquiry status Request:
POST {Base URL}/v2.0/inquiry-status HTTP/1.2
Content-type: application/json
X-TIMESTAMP: 2020-12-17T10:55:00+07:00
X-SIGNATURE: 85be817c55b2c135157c7e89f52499bf0c25ad6eeebe04a986e8c862561b19a5
X-PARTNER-ID: 20001
{
"tradeType": 1,
"orderNo": "2000102900000000000001"
}
Or
{
"tradeType": 2,
"tradeNo": "122200312406111311517153"
}