กฎหมายเลขคำสั่งซื้อ

หมายเลขคำสั่งซื้อเป็นตัวระบุเฉพาะที่ใช้เพื่อติดตามธุรกรรมในระบบการชำระเงิน SmilePayz การปฏิบัติตามรูปแบบที่ถูกต้องช่วยให้การประมวลผลธุรกรรมสำเร็จและการจัดการบันทึกที่เหมาะสม

📋 ข้อกำหนด

ความยาวอักขระ

• ขั้นต่ำ: 6 อักขระ
• สูงสุด: 32 อักขระ
• แนะนำ: 16-24 อักขระเพื่อการอ่านที่ดีที่สุด

อักขระที่อนุญาต

• ตัวเลข: 0-9
• ตัวอักษร: A-Z, a-z (ไม่คำนึงถึงตัวพิมพ์ใหญ่-เล็ก)
• อักขระพิเศษ: ไม่อนุญาต

ความไม่ซ้ำกัน

• หมายเลขคำสั่งซื้อแต่ละหมายเลขต้อง ไม่ซ้ำกันทั่วโลก ภายในบัญชีพ่อค้าของคุณ
• หมายเลขคำสั่งซื้อที่ซ้ำกันจะทำให้ธุรกรรมถูกปฏิเสธ
• หมายเลขคำสั่งซื้อไม่สามารถนำกลับมาใช้ใหม่ในธุรกรรมที่แตกต่างกันได้

🚫 ข้อจำกัด

• ไม่มีช่องว่างหรือสัญลักษณ์พิเศษ (เช่น !@#$%^&*())
• ไม่มีเครื่องหมายขีดหรือขีดล่าง
• ไม่มีอักขระ Unicode หรือ non-ASCII
• ไม่สามารถเริ่มต้นด้วยคำนำหน้าที่สงวนไว้โดยระบบ

💡 แนวทางปฏิบัติที่ดีที่สุด

รูปแบบที่แนะนำ

[PREFIX][TIMESTAMP][RANDOM]

ตัวอย่าง: ORD20241201123456789ABC

ข้อตกลงการตั้งชื่อ

• ใช้คำนำหน้าที่มีความหมาย (เช่น PAY, ORD, TXN)
• รวม timestamp สำหรับการเรียงลำดับตามเวลา
• เพิ่มอักขระสุ่มเพื่อความไม่ซ้ำกัน
• รักษารูปแบบที่สอดคล้องกันในแอปพลิเคชันของคุณ

📝 ตัวอย่างการใช้งาน

{
  "merchantId": "sandbox-20001",
  "orderNo": "T37484Fx383ksd90383",
  "amount": 1000.00,
  "currency": "THB",
  "paymentMethod": "QRPAY"
}

{
  "merchantId": "20001",
  "orderNo": "37484Fx383ksd90383",
  "amount": 1000.00,
  "currency": "THB",
  "paymentMethod": "QRPAY"
}

⚠️ ข้อผิดพลาดที่พบบ่อย

❌ ตัวอย่างที่ไม่ถูกต้อง

"orderNo": "123"           // สั้นเกินไป (น้อยกว่า 6 อักขระ)
"orderNo": "ORDER-123"     // มีเครื่องหมายขีด
"orderNo": "ORDER_123"     // มีขีดล่าง
"orderNo": "ORDER@123"     // มีอักขระพิเศษ
"orderNo": "ORDER 123"     // มีช่องว่าง

✅ ตัวอย่างที่ถูกต้อง

"orderNo": "ORDER123456"   // รูปแบบที่ถูกต้อง
"orderNo": "TXN20241201123456789ABC"  // พร้อม timestamp
"orderNo": "PAYMENT001"    // รูปแบบง่าย
"orderNo": "1234567890ABCDEF"  // ตัวเลขและตัวอักษร

🔍 การตรวจสอบความถูกต้อง

ระบบจะตรวจสอบหมายเลขคำสั่งซื้ออัตโนมัติและจะส่งคืนข้อผิดพลาดหาก:

• ความยาวน้อยกว่า 6 หรือมากกว่า 32 อักขระ
• มีอักขระที่ไม่ถูกต้อง
• หมายเลขคำสั่งซื้อมีอยู่ในระบบแล้ว
• รูปแบบละเมิดกฎใดๆ ที่กำหนดไว้

📊 คำตอบข้อผิดพลาด

หากให้หมายเลขคำสั่งซื้อที่ไม่ถูกต้อง API จะส่งคืน:

{
  "code": "INVALID_ORDER_NO",
  "message": "รูปแบบหมายเลขคำสั่งซื้อไม่ถูกต้องหรือมีอยู่แล้ว",
  "data": null
}

---

หมายเหตุ: สร้างหมายเลขคำสั่งซื้อที่ไม่ซ้ำกันสำหรับแต่ละธุรกรรมเสมอเพื่อให้แน่ใจว่าการติดตามที่เหมาะสมและหลีกเลี่ยงความขัดแย้งในระบบการชำระเงิน