บันทึกการชำระเงิน: คู่มือตรวจสอบคำสั่งซื้อและปกปิดข้อมูล callback
ลูกค้าแจ้งว่าจ่ายแล้ว แต่ยอดคงเหลือในเว็บไซต์ยังไม่เพิ่ม ควรตรวจบันทึกใดก่อน? บันทึกที่เชื่อมโยง ตรวจสอบเทียบกันได้ และปกปิดข้อมูลแล้ว ช่วยให้เจ้าของเว็บไซต์กับทีมเทคนิคตรวจคำสั่งซื้อเดียวกันได้ บทความนี้เสนอแนวทางฝั่งร้านค้า ตัวอย่างไม่ใช่ฟิลด์ API ของ 稳付pay และภาพบันทึกไม่สามารถใช้แทนหลักฐานการชำระเงินได้
สารบัญบทความ
1. แยกการชำระเงิน callback การเพิ่มยอด และการชำระบัญชี
การเติมเงินหนึ่งรายการมีหลายสถานะ เช่น ยืนยันการชำระเงิน ส่งแจ้งเตือนถึงร้านค้า ตรวจสอบลายเซ็น บันทึกยอดลงบัญชี และชำระบัญชีเสร็จ การตอบรับ callback สำเร็จเพียงอย่างเดียวไม่ได้ยืนยันว่าเพิ่มยอดให้ผู้ใช้แล้ว และยอดผู้ใช้ที่เพิ่มขึ้นก็ไม่ได้พิสูจน์ว่าร้านค้าได้รับเงินชำระบัญชี ควรบันทึกข้อเท็จจริงแต่ละอย่างแยกกัน
บริการรับชำระผ่าน WeChat/Alipay กับบริการติดตาม USDT ของ 稳付pay มีเส้นทางเงินต่างกัน การชำระบัญชีเป็น USDT หลังรับชำระเป็นไปตามข้อตกลงร้านค้า ส่วนการติดตามบนเชน ลูกค้าจ่ายเข้ากระเป๋าของร้านค้าโดยตรง แพลตฟอร์มไม่รับหรือเก็บรักษาเงิน ปัจจุบันรองรับ Tron (TRC20) และ Ethereum (ERC20) และแจ้งเตือนหลังครบเงื่อนไขยืนยันที่ตั้งไว้ จึงต้องแยกเหตุการณ์รับเงินเหล่านี้ออกจากกัน
2. ใช้หมายเลขคำสั่งซื้อเชื่อมโยงขั้นตอนทั้งหมด
ควรใช้หมายเลขคำสั่งซื้อภายในร้านค้าเป็นจุดเชื่อมหลัก แล้วเชื่อมกับหมายเลขคำสั่งซื้อแพลตฟอร์ม รหัสคำขอภายใน ประวัติการแจ้งเตือนแต่ละครั้ง และรหัสรายการบัญชี หนึ่งคำสั่งซื้ออาจมีหลายคำขอหรือแจ้งซ้ำ จึงห้ามสร้างคำสั่งซื้อธุรกิจใหม่ทุกครั้งที่มีแจ้งเตือน สามารถใช้รหัสติดตามแบบสุ่มระหว่างบริการได้ แต่ไม่ควรฝังอีเมล เบอร์โทร หรือรหัสผู้ใช้จริง และห้ามใช้รหัสติดตามเป็นข้อมูลยืนยันตัวตน
สำหรับรายการบนเชน ควรเก็บเครือข่าย สินทรัพย์ แฮชธุรกรรม และข้อมูลตำแหน่งเหตุการณ์ที่จำเป็นต่อการระบุรายการโอน แฮชเพียงอย่างเดียวอาจแยกหลายรายการโอนในธุรกรรมเดียวกันไม่ได้ จำนวนเงินต้องมีสกุลและหน่วยกำกับ แยกเงินทั่วไปกับจำนวน USDT และใช้จำนวนเต็มในหน่วยย่อยหรือเลขทศนิยมที่แม่นยำแทนเลขทศนิยมฐานสอง แม้ที่อยู่กระเป๋าเป็นข้อมูลสาธารณะบนเชน แต่เมื่อเชื่อมกับคำสั่งซื้อผู้ใช้แล้วก็ควรจำกัดการส่งต่อ
3. บันทึกลำดับเหตุการณ์แทนการเก็บคำขอทั้งชุด
แต่ละเหตุการณ์อาจบันทึกเวลาเกิด เวลารับ หมายเลขอ้างอิงคำสั่งซื้อ ขั้นตอน ผลลัพธ์ ระยะเวลา และประเภทข้อผิดพลาดที่คัดแล้ว ควรใช้เวลาพร้อมเขตเวลาและตรวจนาฬิกาเซิร์ฟเวอร์ หากงานแบบอะซิงโครนัสทำงานภายหลัง ให้เก็บทั้งสองเวลา ตัวอย่างด้านล่างเป็นรูปแบบบันทึกที่ร้านค้ากำหนดเอง ชื่อฟิลด์ เหตุการณ์ และสถานะไม่ใช่ข้อกำหนด API ของแพลตฟอร์ม
{
"occurred_at": "2026-10-22T09:15:00+07:00",
"order_ref": "DEMO-ORDER-001",
"request_ref": "DEMO-REQUEST-001",
"event": "callback_authentication",
"result": "verified",
"duration_ms": 12,
"environment": "example_only"
}ควรติดตามตามลำดับตั้งแต่สร้างคำสั่งซื้อ ตรวจสถานะ รับ callback ยืนยันตัวตน บันทึกบัญชี ไปจนถึงส่งมอบบริการ บันทึกรหัส HTTP และผลว่าข้อความตอบรับตรงตามโปรโตคอลหรือไม่ โดยไม่คัดลอกเนื้อหาตอบกลับ header หรือลายเซ็นทั้งชุด คำขอหมดเวลาต้องเป็นผลที่รอตรวจ ไม่ควรเปลี่ยนเป็นชำระล้มเหลวทันที และข้อผิดพลาดในการเขียนบันทึกต้องไม่ทำให้เรียกเก็บเงินหรือเพิ่มยอดซ้ำ
4. ปกปิดข้อมูลก่อนเขียนบันทึก
ใช้รายการฟิลด์ที่อนุญาตและเก็บเฉพาะข้อมูลที่จำเป็นต่อการตรวจสอบ ไม่บันทึกคีย์ API รหัสผ่าน Cookie Authorization ลายเซ็นต้นฉบับ คีย์ส่วนตัวกระเป๋า หรือวลีกู้คืนในบันทึกทั่วไป ลบโทเคนใน query ของ URL callback และกรองอีเมล เบอร์โทร และหมายเหตุผู้ใช้ การเก็บทั้งหมดก่อนแล้วค่อยเซ็นเซอร์ภาพอาจช้าเกินไป เพราะตัวรวบรวมข้อมูล สำรองข้อมูล หรือระบบติดตามข้อผิดพลาดอาจมีต้นฉบับแล้ว
จำกัดความยาวข้อมูลจากภายนอกและจัดการตัวขึ้นบรรทัดใหม่ อักขระควบคุม และข้อความที่ไม่น่าเชื่อถือ เพื่อไม่ให้หมายเหตุปลอมเป็นบันทึกอีกรายการ การตรวจลายเซ็นยังต้องใช้ข้อมูลต้นฉบับตามโปรโตคอล สำเนาที่ปกปิดแล้วมีไว้บันทึกเท่านั้น หากจำเป็นต้องเก็บหลักฐานวินิจฉัยเพิ่มเติม ให้แยกพื้นที่จำกัดสิทธิ์ มีบันทึกการเข้าถึงและกำหนดลบ และไม่วางในโฟลเดอร์เว็บไซต์ที่ดาวน์โหลดได้สาธารณะ
5. ตรวจกรณีจ่ายแล้วแต่ยอดยังไม่เพิ่ม
เริ่มจากเทียบคำสั่งซื้อร้านค้า สกุลเงิน จำนวนเงิน และสถานะชำระที่ตรวจสอบได้ในปัจจุบัน แล้วดูว่าแจ้งเตือนถึงสภาพแวดล้อมที่ถูกต้องหรือไม่ จากนั้นตรวจการยืนยันตัวตน จำนวนเงิน การเปลี่ยนสถานะ และการ commit รายการบัญชี การแจ้งซ้ำอาจมีบันทึกรับหลายรายการได้ แต่การทำธุรกิจเดียวกันต้องมีการเปลี่ยนบัญชีที่มีผลเพียงครั้งเดียว ควรบันทึกผลการกันซ้ำอย่างชัดเจน ไม่ใช่เพิ่มยอดอีกครั้ง
หากพบธุรกรรมบนเชนแล้วแต่ยังไม่ครบเงื่อนไขยืนยันที่ตั้งไว้ ให้คงสถานะรอยืนยัน เมื่อยืนยันแล้วจึงตรวจการจับคู่คำสั่งซื้อ การแจ้ง และการเพิ่มยอดฝั่งร้านค้าต่อ ไม่ควรเพิ่มยอดด้วยมือจากการเปลี่ยนหน้าฝั่งลูกค้าหรือภาพเพียงภาพเดียว หากต้องปรับยอด ต้องตรวจสอบแยกต่างหาก ใช้ขั้นตอนแก้ไขบัญชีที่มีสิทธิ์ บันทึกเหตุผล ผู้อนุมัติ และรายการปรับยอด พร้อมป้องกัน callback ที่มาทีหลังเพิ่มเงินซ้ำ
6. เตรียมข้อมูลขั้นต่ำให้ทีมเทคนิค
เตรียมหมายเลขอ้างอิงคำสั่งซื้อที่มีปัญหา เวลาและเขตเวลา วิธีชำระหรือเครือข่าย ผลที่คาดหวัง อาการจริง และเหตุการณ์ใกล้เคียงที่ปกปิดแล้ว ส่งหมายเลขคำสั่งซื้อเต็มเป็นการส่วนตัวเฉพาะเมื่อจำเป็นผ่านช่องทางสนับสนุนที่ตรวจสอบแล้ว ส่วนภาพหรือคำถามสาธารณะใช้รหัสแทน ห้ามส่งข้อมูลเข้าระบบผู้ดูแล ไฟล์ตั้งค่าทั้งชุด คีย์ส่วนตัว หรือฐานข้อมูลทั้งหมด
ควรระบุด้วยว่าเคยลองใหม่ เปลี่ยนช่องทาง ปรับรายการด้วยมือหรือไม่ และระบบยังประมวลผลอัตโนมัติอยู่หรือไม่ เพื่อให้ทีมเทคนิคแยกปัญหาฝั่งชำระเงิน เส้นทางแจ้งเตือน หรือบัญชีร้านค้าได้ ใช้เอกสารที่ยืนยันแล้วของบริการ 稳付pay แต่ละประเภทสำหรับการยืนยันตัวตน การตอบรับ และการลองใหม่ อย่านำโปรโตคอลรับชำระ WeChat/Alipay ไปใช้กับบริการติดตาม USDT
7. ระยะเวลาเก็บ สิทธิ์เข้าถึง และการตรวจก่อนใช้งาน
กำหนดระยะเวลาเก็บตามวัตถุประสงค์และข้อกำหนดที่ใช้ แยกบันทึกการดูแลระบบออกจากบัญชีธุรกรรมอย่างเป็นทางการ การล้างบันทึกต้องไม่ลบข้อมูลบัญชีที่จำเป็นต้องเก็บ จำกัดสิทธิ์ดูและส่งออก มีประวัติการเข้าถึง ปกป้องข้อมูลระหว่างเก็บและส่ง และไม่เปิดโฟลเดอร์บันทึกต่อสาธารณะ ตั้งการหมุนเวียนไฟล์และเตือนพื้นที่ เพื่อไม่ให้ดิสก์เต็มกระทบการรับชำระหรือทำให้เหตุการณ์บัญชีสำคัญหายโดยไม่แจ้ง
ก่อนใช้งานจริง ให้ใช้ข้อมูลสาธิตตรวจแจ้งปกติ แจ้งซ้ำ ยืนยันตัวตนไม่ผ่าน หมดเวลา และบันทึกบัญชีไม่สำเร็จ เพื่อให้หาต้นเหตุได้โดยไม่รั่วไหล การตรวจนี้ใช้กับบันทึกและกระบวนการที่ร้านค้าพัฒนาเอง ไม่จำเป็นต้องเรียกชำระเงินจริง และไม่ได้หมายความว่าแพลตฟอร์มมี sandbox สาธารณะ ที่อยู่ สิทธิ์ และวิธีทดสอบการเชื่อมต่อต้องยืนยันกับทีมเทคนิคก่อน
8. คำถามที่พบบ่อย
HTTP 200 แปลว่าเติมเงินเสร็จแล้วหรือไม่?
ไม่ใช่ รหัส HTTP ข้อความตอบรับตามโปรโตคอล ผลตรวจลายเซ็น และการ commit บัญชีเป็นหลักฐานคนละชั้น ต้องตรวจตามโปรโตคอลที่ใช้และเทียบบัญชีร้านค้า ไม่ถือว่าการส่งสำเร็จคือเพิ่มยอดแล้ว
ส่ง callback ทั้งชุดลงกลุ่มเพื่อช่วยตรวจได้หรือไม่?
ไม่ควร คัดเฉพาะฟิลด์ที่จำเป็นและปกปิดก่อนส่งผ่านช่องทางสนับสนุนที่ยืนยันแล้ว หากพบคีย์ลับในบันทึก ให้จำกัดสิทธิ์เข้าถึงทันทีและประสานทีมเทคนิคเพื่อเปลี่ยนคีย์และจัดการสำเนาที่เกี่ยวข้อง การลบภาพเพียงภาพเดียวไม่เพียงพอ
บันทึกระบุว่ายืนยันแล้ว ทำไมต้องเทียบบัญชีอีก?
บันทึกใช้สังเกตขั้นตอน ส่วนบัญชีใช้บันทึกยอดที่เปลี่ยนจริง หลังยืนยันบนเชนแล้ว การแจ้ง จับคู่คำสั่งซื้อ หรือ commit ฐานข้อมูลยังอาจล้มเหลวได้ ต้องตรวจทั้งกระบวนการและให้แน่ใจว่าการตรวจย้อนหลังหรือประมวลผลแจ้งใหม่ไม่เพิ่มยอดสองครั้ง
แหล่งอ้างอิง
อ้างอิง OWASP สำหรับความปลอดภัยของบันทึก และ W3C สำหรับรหัสติดตามระหว่างบริการ ฟิลด์บันทึกและขั้นตอนตรวจสอบในบทความเป็นคำแนะนำฝั่งร้านค้า ส่วนโปรโตคอลชำระเงินจริงให้ยึดเอกสารที่ยืนยันเมื่อเชื่อมต่อ
ยืนยันการเชื่อมต่อให้ตรงธุรกิจของคุณ
แจ้งสินค้า ปริมาณคำสั่งซื้อ วิธีชำระเงิน และความต้องการชำระยอด เพื่อยืนยัน API เส้นทางเงิน และการจัดการปัญหาทีละข้อ
ติดต่อ 稳付pay ↗