API สอบถามสถานะ

คำขอ

API สอบถามสถานะธุรกรรมช่วยให้ผู้ค้าสามารถดึงข้อมูลสถานะธุรกรรมแบบเรียลไทม์ ประเภทธุรกรรมที่รองรับ

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

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

พารามิเตอร์ส่วนหัว

ฟิลด์	จำเป็น	ประเภท	คำอธิบาย
Content-Type	M	String	ข้อกำหนดประเภทเนื้อหา HTTP ค่าคงที่: application/json จำเป็นสำหรับการแยกวิเคราะห์คำขอที่เหมาะสม
X-TIMESTAMP	M	String	รูปแบบวันที่เวลา ISO 8601 พร้อมออฟเซ็ตเขตเวลา รูปแบบ: yyyy-MM-ddTHH:mm:ss±HH:mm ตัวอย่าง: 2020-12-17T10:55:00+07:00 หมายเหตุ: ต้องเป็นเวลาของเซิร์ฟเวอร์ปัจจุบันภายใน ±5 นาที
X-SIGNATURE	M	String	ลายเซ็นดิจิทัลสำหรับการยืนยันตัวตนคำขอ ดู การสร้างลายเซ็น
X-PARTNER-ID	M	String	ตัวระบุผู้ค้าเฉพาะที่กำหนดโดยแพลตฟอร์ม รูปแบบ: สตริงตัวอักษรและตัวเลข ใช้สำหรับการยืนยันตัวตนผู้ค้าและการจัดเส้นทางธุรกรรม กรุณาใส่ merchantID

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

ฟิลด์	จำเป็น	ประเภท	คำอธิบาย
tradeType	M	Number	ข้อกำหนดประเภทธุรกรรม รูปแบบ: ค่าจำนวนเต็ม ค่า: 1 (รับเงิน), 2 (จ่ายเงิน) ใช้เพื่อระบุหมวดหมู่ธุรกรรมสำหรับการสอบถามสถานะ
orderNo	C	String(32)	ตัวระบุธุรกรรมของผู้ค้า รูปแบบ: สตริงตัวอักษรและตัวเลข ความยาวสูงสุด: 32 ตัวอักษร ใช้เมื่อสอบถามโดยอ้างอิงธุรกรรมของผู้ค้า
tradeNo	C	String(32)	ตัวระบุธุรกรรมภายใน รูปแบบ: สตริงตัวอักษรและตัวเลข ความยาวสูงสุด: 32 ตัวอักษร ใช้เมื่อสอบถามโดยอ้างอิงธุรกรรมของระบบ

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

ต้องมีตัวระบุธุรกรรม: ต้องให้ 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": "112200312406111311517153"
}

การตอบกลับ

การตอบกลับ HTTP

ฟิลด์	จำเป็น	ประเภท	คำอธิบาย
Content-Type	M	String	ข้อกำหนดประเภทเนื้อหาการตอบกลับ HTTP ค่าคงที่: application/json ระบุรูปแบบการตอบกลับ JSON
X-TIMESTAMP	M	String	รูปแบบวันที่เวลา ISO 8601 พร้อมออฟเซ็ตเขตเวลา รูปแบบ: yyyy-MM-ddTHH:mm:ss±HH:mm ตัวอย่าง: 2020-12-17T10:55:00+07:00

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

ฟิลด์	จำเป็น	ประเภท	คำอธิบาย
code	M	String	รหัสสถานะการตอบกลับ API ที่ระบุผลการดำเนินการ รูปแบบ: สตริงสองหลัก สำเร็จ: "00", ข้อผิดพลาด: รหัสอื่นๆ ใช้สำหรับการจัดการการตอบกลับแบบโปรแกรม
message	M	String	คำอธิบายสถานะการตอบกลับที่อ่านได้ รูปแบบ: สตริงที่เข้ารหัส UTF-8 ให้ข้อมูลรายละเอียดเกี่ยวกับผลการดำเนินการ แปลเป็นภาษาตามภาษาของคำขอ
tradeNo	O	String	หมายเลขอ้างอิงธุรกรรมภายในสำหรับการติดตามระบบ รูปแบบ: สตริงตัวอักษรและตัวเลขที่สร้างโดยระบบ ใช้สำหรับการจัดการธุรกรรมภายในและการสนับสนุน
tradeType	O	Number	ข้อกำหนดประเภทธุรกรรม รูปแบบ: ค่าจำนวนเต็ม ค่า: 1 (รับเงิน), 2 (จ่ายเงิน) ระบุหมวดหมู่ธุรกรรมที่ถูกสอบถาม
paymentMethod	O	String	วิธีการชำระเงินที่ใช้สำหรับการประมวลผลธุรกรรม รูปแบบ: รหัสวิธีการชำระเงินที่กำหนดไว้ล่วงหน้า ตัวอย่าง: CPF, PIX, BOLETO ระบุช่องทางการชำระเงินที่ใช้จริง ดู รายการวิธีการชำระเงิน
money	O	Object	รายละเอียดจำนวนธุรกรรมพร้อมข้อกำหนดสกุลเงิน มีจำนวนธุรกรรมที่ยืนยันและสกุลเงิน ดู โมเดลเงิน
currency	M	String	ข้อกำหนดรหัสสกุลเงิน ISO 4217 ค่าคงที่: BRL (Real บราซิล) กำหนดกฎการประมวลผลการชำระเงินและสกุลเงินการชำระบัญชี
amount	M	Number	จำนวนธุรกรรมในหน่วยสกุลเงินที่เล็กที่สุด รูปแบบ: ค่าจำนวนเต็ม ตัวอย่าง: 20000 แทน BRL 20000 ช่วง: 100-999999999
status	O	String	สถานะการประมวลผลธุรกรรมปัจจุบัน รูปแบบ: รหัสสถานะที่กำหนดไว้ล่วงหน้า ตัวอย่าง: PROCESSING, SUCCESS, FAILED, CANCELLED ระบุสถานะปัจจุบันของธุรกรรม ดู โมเดลสถานะ
remark	O	String	ข้อมูลธุรกรรมเพิ่มเติมหรือหมายเหตุ รูปแบบ: สตริงที่เข้ารหัส UTF-8 มีรายละเอียดเพิ่มเติมเกี่ยวกับสถานะธุรกรรม

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

{
    "code": "00",
    "message": "สำเร็จ",
    "money": {
        "amount": 20000,
        "currency": "BRL"
    },
    "paymentMethod": "CPF",
    "status": "SUCCESS",
    "tradeNo": "122200312406111311517153",
    "tradeType": 2
}