API INQUIRY STATUS

API สอบถามสถานะธุรกรรม ภูมิภาค USDT (USDT).

Request

API สอบถามสถานะธุรกรรม (Transaction Status Inquiry) ช่วยให้ร้านค้าสามารถตรวจสอบสถานะของธุรกรรมได้แบบเรียลไทม์ รองรับทั้งธุรกรรมรับเงิน (Pay-in), ธุรกรรมจ่ายเงินออก (Payout) และธุรกรรมประเภทอื่น ๆ

เส้นทางคำขอ (Request Path):

sandbox: https://sandbox-gateway.smilepayz.com/v2.0/inquiry-status
production: https://gateway.smilepayz.com/v2.0/inquiry-status

พารามิเตอร์ใน Header

Field	Required	Type	Description
Content-Type	M	String	application/json request body.
X-TIMESTAMP	M	String	Datetime with zone offset, format yyyy-MM-ddTHH:mm:ss±HH:mm
X-SIGNATURE	M	String	Signature of JSON body (see product Signature doc).
X-PARTNER-ID	M	String	Your merchantID

พารามิเตอร์ใน Body

Field	Required	Type	Description
tradeType	M	Number	ประเภทของธุรกรรม รูปแบบ: ค่าจำนวนเต็มตัวเลข ค่า: 1 (Payin), 2 (Payout) ใช้ระบุหมวดหมู่ของธุรกรรมที่ต้องการสอบถามสถานะ
orderNo	C	String(32)	Merchant-unique id
tradeNo	C	String(32)	Smilepayz tradeNo for this order.

ข้อกำหนดที่สำคัญ

ต้องระบุรหัสอ้างอิงธุรกรรมอย่างน้อยหนึ่งค่า: ต้องระบุ tradeNo หรือ orderNo อย่างน้อยหนึ่งค่าเพื่อใช้ในการสอบถามสถานะของธุรกรรม

ตัวอย่าง Body – คำขอสอบถามสถานะธุรกรรม (Inquiry Status Request):

Content-type: application/json
X-TIMESTAMP: 2020-12-17T10:55:00+07:00
X-SIGNATURE: 85be817c55b2c135157c7e89f52499bf0c25ad6eeebe04a986e8c862561b19a5
X-PARTNER-ID: 20001

{
    "tradeType": 1,
    "orderNo": "2000112900000000000001"
}

{
    "tradeType": 2,
    "tradeNo": "112200312406111311517153"
}

Response

HTTP Response

Field	Required	Type	Description
Content-Type	M	String	application/json request body.
X-TIMESTAMP	M	String	Datetime with zone offset, format yyyy-MM-ddTHH:mm:ss±HH:mm

พารามิเตอร์ใน Body

Field	Required	Type	Description
code	M	String	00 success, other values error.
message	M	String	UTF-8 human-readable result line.
tradeNo	O	String	Smilepayz tradeNo for this order.
tradeType	O	Number	ประเภทของธุรกรรม รูปแบบ: ค่าจำนวนเต็มตัวเลข ค่า: 1 (Payin), 2 (Payout) ใช้ระบุหมวดหมู่ของธุรกรรมที่มีการสอบถาม
paymentMethod	O	String	See Payment methods doc.
money	O	Object	Currency plus amount for this transaction.
currency	M	String	Fixed to USDT.
amount	M	Number	Amount
status	O	String	Order or payment​ status enum value.
remark	O	String	ข้อมูลหรือหมายเหตุเพิ่มเติมเกี่ยวกับธุรกรรม รูปแบบ: สตริง UTF-8 อาจมีรายละเอียดเสริมเกี่ยวกับสถานะหรือเหตุผลของผลลัพธ์ของธุรกรรม

Content-type: application/json 
X-TIMESTAMP: 2020-12-17T10:55:00+07:00

{
    "code": "00",
    "message": "Successful",
    "money": {
        "amount": 20000,
        "currency": "USDT"
    },
    "paymentMethod": "USDT",
    "status": "SUCCESS",
    "tradeNo": "122200312406111311517153",
    "tradeType": 2
}