สถานะธุรกรรม (เวียดนาม)

API สอบถามสถานะธุรกรรม ภูมิภาคเวียดนาม (VND)

คำขอ

POST/v2.0/inquiry-status

เส้นทางคำขอ:

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

พารามิเตอร์หัวข้อ

Field	จำเป็น	ประเภท	คำอธิบาย
Content-Type	M	String	เนื้อหาคำขอ application/json
X-TIMESTAMP	M	String	รูปแบบ: yyyy-MM-ddTHH:mm:ss±HH:mm
X-SIGNATURE	M	String	ลายเซ็นของเนื้อหา JSON (ดู Signature)
X-PARTNER-ID	M	String	Your merchantID

พารามิเตอร์เนื้อหา

Field	จำเป็น	ประเภท	คำอธิบาย
tradeType	M	Number	1 = Pay-in, 2 = Pay-out
orderNo	C	String(32)	รหัสไม่ซ้ำของร้านค้า 6–32 อักขระอักษรและตัวเลข
tradeNo	C	String(32)	tradeNo Smilepayz สำหรับคำสั่งซื้อนี้

ข้อกำหนด

ต้องส่งอย่างน้อยหนึ่งค่าระหว่าง tradeNo หรือ orderNo

---

ตัวอย่างเนื้อหา – คำขอสอบถามสถานะ:

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": "192200312406111311517153"
}

การตอบกลับ

HTTP (คำขอ)

Field	จำเป็น	ประเภท	คำอธิบาย
Content-Type	M	String	เนื้อหา application/json
X-TIMESTAMP	M	String	รูปแบบ: yyyy-MM-ddTHH:mm:ss±HH:mm

พารามิเตอร์เนื้อหา

Field	จำเป็น	ประเภท	คำอธิบาย
code	M	String	00 สำเร็จ ค่าอื่นคือข้อผิดพลาด
message	M	String	ข้อความผลลัพธ์ UTF-8 ที่อ่านได้
tradeNo	O	String	tradeNo Smilepayz สำหรับคำสั่งซื้อนี้
tradeType	O	Number	1 Pay-in / 2 Pay-out
paymentMethod	O	String	รหัส (ดู วิธีการชำระเงิน)
money	O	Object	สกุลเงิน และ จำนวนเงิน ของธุรกรรมนี้
currency	M	String	คงที่เป็น VND
amount	M	Number	Amount
status	O	String	ค่าสถานะคำสั่งซื้อหรือการชำระเงิน
remark	O	String	หมายเหตุเพิ่มเติมหากมี

ตัวอย่างเนื้อหา – การตอบกลับสอบถามสถานะ:

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

{
    "code": "00",
    "message": "Successful",
    "tradeNo": "192200312406111311517153",
    "tradeType": 2,
    "paymentMethod": "W_MOMO",
    "money": {
        "currency": "VND",
        "amount": 20000
    },
    "status": "SUCCESS"
}