เชื่อมต่อการชำระเงินกับระบบส่งรหัสดิจิทัล: ลายเซ็น การป้องกันผลซ้ำ ล็อกสต็อก และส่งมอบอัตโนมัติ
การส่งรหัสอัตโนมัติไม่ใช่แค่ได้รับข้อความว่า “ชำระสำเร็จ” แล้วส่งรหัสออกไป ขั้นตอนที่เชื่อถือได้ต้องเชื่อมการแจ้งชำระที่ตรวจสอบแล้ว สถานะคำสั่งซื้อ การจัดสรรสต็อก และงานส่งมอบ โดยรองรับการลองเครือข่ายใหม่ การเริ่มกระบวนการใหม่ และการแก้ด้วยคน บทความนี้เป็นแนวทางทั่วไปไม่ผูกผู้ให้บริการ ฟิลด์ ลายเซ็น และคำตอบรับทั้งหมดต้องทำตามข้อตกลงเชื่อมต่อจริง ไม่ใช่ข้อกำหนด API ของ 稳付pay
สารบัญบทความ
แยกสถานะการจ่ายเงินกับการส่งมอบเป็นสองมิติ
อย่างน้อยต้องแยกสถานะรอจ่าย จ่ายแล้ว และคืนแล้ว ออกจากรอจัดสรร จัดสรรแล้ว ส่งมอบแล้ว และส่งมอบผิดพลาด มิฉะนั้น เมื่อจ่ายแล้วแต่ของขาด ระบบจะเลือกได้แค่ “สำเร็จ” หรือ “ล้มเหลว” ซึ่งไม่รักษาข้อเท็จจริงระหว่างทาง
- สร้างคำสั่งซื้อเซิร์ฟเวอร์กำหนดสินค้า จำนวนเงิน สกุลเงิน และอายุรายการ
- ยืนยันการจ่ายเงินตรวจลายเซ็น ตรวจฟิลด์ และบันทึกข้อเท็จจริงการจ่ายอย่างถาวร
- จัดสรรสต็อกล็อกคำสั่งซื้อและรหัสที่เกี่ยวข้องภายในธุรกรรม
- ส่งมอบลองงานถาวรใหม่และเก็บผลส่งมอบ
จำนวนสินค้า ราคา และส่วนลดคำนวณโดยเซิร์ฟเวอร์ ไม่รับยอดสุดท้ายจากเบราว์เซอร์ตรงๆ เก็บราคาขณะสร้างคำสั่งซื้อไว้ แม้สินค้าขึ้นราคาภายหลังก็ไม่เปลี่ยนเงื่อนไขการจ่ายเดิม
ตรวจลายเซ็นก่อน แล้วตรวจร้านค้า จำนวนเงิน และเจ้าของรายการ
จัดการแจ้งกลับในระบบหลังบ้าน ตรวจลายเซ็น ข้อมูลที่ครอบคลุม ช่วงเวลา และคีย์ตามเอกสาร หากผู้ให้บริการต้องใช้เนื้อหาคำขอดิบ ต้องเก็บไบต์เดิมก่อนเฟรมเวิร์กแปลงหรือจัดรูปแบบใหม่ คู่มือ Webhook ของ Stripe เป็นตัวอย่างกลไกนี้ แต่ฟิลด์และส่วนหัวลายเซ็นนำไปใช้กับบริการอื่นตรงๆ ไม่ได้
ลายเซ็นผ่านเพียงแปลว่าข้อความตรงโปรโตคอลของคีย์นั้น ยังต้องตรวจตัวตนร้านค้า เจ้าของคำสั่งซื้อ หมายเลขธุรกรรม สกุลเงิน ยอดจริง และสถานะสำเร็จสุดท้าย เปรียบเทียบยอดด้วยจำนวนเต็มในหน่วยย่อยที่ชัดเจนหรือ fixed-point แม่นยำ ไม่ใช้การเท่ากันโดยประมาณของ floating-point
สำหรับ USDT ต้องตรวจเครือข่าย ที่อยู่รับ และตัวระบุสินทรัพย์ ไม่ดูแค่ชื่อโทเคน URL return รูปหลักฐาน และคำบอกลูกค้าทดแทนไม่ได้ คีย์ต้องอยู่บนเซิร์ฟเวอร์ ไม่ใส่ในสคริปต์หน้าเว็บ
การตัดซ้ำต้องมีข้อกำหนดในฐานข้อมูล ไม่ใช่แค่ “ค้นก่อน”
สถานการณ์ล้มเหลวที่หนึ่ง: แจ้งสองข้อความมาพร้อมกัน สองกระบวนการต่างพบว่ายังไม่ส่งมอบ จึงส่งรหัสคนละชุด เกิดการแข่งขันระหว่างการอ่านและเขียน แม้ใช้เครื่องเดียวก็เกิดได้ ต้องตัดซ้ำด้วย unique constraint และธุรกรรมในฐานข้อมูล ไม่ใช่ธงในหน่วยความจำอย่างเดียว
แยกตัดซ้ำระดับเหตุการณ์ ธุรกรรมจ่าย และการส่งมอบ การจ่ายเดียวอาจมีหลาย event ID ดังนั้นทำ event ID ไม่ซ้ำอย่างเดียวยังรับรู้การจ่ายซ้ำได้ เหตุการณ์เดิมส่งซ้ำต้องไม่เลื่อนสถานะอีก ข้อความที่จัดการแล้วตอบรับตามโปรโตคอลได้หลังตรวจบันทึกถาวร
ตัวอย่างต่อไปเป็นข้อกำหนดทั่วไปในตารางแจ้งเตือน ตารางจ่าย ตารางงานส่งมอบ และตารางจัดสรรตามลำดับ ไม่ใช่สคริปต์สร้างตารางเดียว ต้องออกแบบ non-null ขอบเขต และไวยากรณ์จริงร่วมกัน เอกสาร constraints ของ PostgreSQL อธิบายการรับประกันความไม่ซ้ำในฐานข้อมูล
UNIQUE (provider, provider_event_id)
UNIQUE (provider, provider_transaction_id)
UNIQUE (order_id, fulfillment_kind)
UNIQUE (card_id)ใช้ธุรกรรมปกป้องการจัดสรรสต็อก ป้องกันขายชิ้นสุดท้ายเกิน
เมื่อจัดการการจ่ายสำเร็จ ให้ล็อกคำสั่งซื้อในธุรกรรมและตรวจว่าจัดสรรแล้วหรือไม่ ใช้ row lock หรือ atomic update ที่มีเงื่อนไขกับรหัสที่รอจัดสรร แล้ว commit บันทึกจัดสรรกับสถานะคำสั่งซื้อพร้อมกัน ห้ามส่งรหัสก่อนแล้วค่อยพยายามทำเครื่องหมายขายแล้ว
หากใช้ compare-and-set หรือ CAS เงื่อนไขต้องมี “ยังพร้อมใช้” และตรวจว่าแก้ได้หนึ่งแถวเท่านั้น หากศูนย์แถว ให้เลือกสต็อกใหม่หรือเข้าสู่ของขาด คำสั่งซื้อหลายชิ้นต้องมีกฎจัดสรรรวมชัดเจน ไม่ส่งเพียงบางส่วนโดยไม่ตั้งใจ
เอกสาร row lock ของ PostgreSQL แสดงการประสานงานพร้อมกัน ควรถือ lock สั้น ไม่เรียกอีเมลหรือ API อนุญาตสิทธิ์ภายนอกในธุรกรรมยาว เมื่อ deadlock หรือ conflict ที่ลองใหม่ได้ ให้ลองทั้งธุรกรรมตาม semantics ฐานข้อมูลและรักษาการไม่สร้างผลซ้ำ
ใช้ Outbox เชื่อมฐานข้อมูลกับการส่งมอบภายนอก
ธุรกรรมบันทึกคำสั่งซื้อกับสต็อกพร้อมกันได้ แต่ไม่ทำให้ฐานข้อมูลกับผู้ส่งอีเมลสำเร็จพร้อมกันโดยธรรมชาติ จึงเขียนงานส่งมอบถาวรหรือ Outbox ในธุรกรรมเดียวกับข้อมูลธุรกิจ แล้วให้ worker แยกส่งและบันทึกผลภายหลัง
# Generic flow; adapt to the actual provider protocol.
event = verify_provider_request(raw_request)
with database_transaction():
persist_inbox_event_once(event)
record_verified_payment_once(event)
allocate_inventory_if_needed(event.order_id)
persist_outbox_job_once(event.order_id)
return protocol_ack_after_commit()
นี่เป็นภาพรวมขั้นตอนที่ละกรณีซ้ำ ตรวจไม่ผ่าน และของขาด หากไม่มีสต็อก ให้บันทึก “จ่ายแล้วรอดำเนินการ” กับงานให้คนตรวจ ไม่สร้างประวัติส่งมอบปลอม หากบันทึกถาวรล้มเหลว ห้ามตอบว่ารับสำเร็จก่อน ต้องให้ลองใหม่ตามโปรโตคอลหรือมีขั้นตอนตรวจชดเชยชัดเจน
ตอบรับข้อความไม่จำเป็นต้องรอส่งอีเมล แต่ข้อความและงานถัดไปต้องถูกบันทึกถาวรแล้ว หากมีเพียงคิวในหน่วยความจำ การตอบก่อนแล้วรีสตาร์ตอาจทำให้งานส่งมอบหายถาวร
แยกจัดการของขาด จ่ายล่าช้า และทำงานซ้ำ
สถานการณ์ล้มเหลวที่สอง: คำสั่งซื้อหมดอายุและปล่อยสต็อกแล้ว แต่แจ้งการจ่ายมาช้า หากมองข้ามรายการปิด จะค้างการจ่ายที่ไม่จัดการ หากใช้สต็อกเดิม อาจส่งรหัสที่ขายแล้วให้คนที่สอง ต้องเก็บข้อเท็จจริงการจ่าย ตรวจสต็อกและกฎใหม่ แล้วเติมของ ส่งมอบด้วยคน หรือคืนเงิน
worker อาจล้มหลังส่งมอบภายนอกสำเร็จแต่ก่อนบันทึกผล ลองใหม่ด้วย fulfillment ID เดิม และใช้ idempotency key หรือสอบถามผลของระบบภายนอกหากมี หากไม่มี ต้องออกแบบกระทบยอดและให้คนตรวจ คิวภายในอย่างเดียวรับประกันไม่ได้ว่าภายนอกไม่มีผลซ้ำเด็ดขาด
แสดงรหัสเดิมที่จัดสรรแล้วให้ลูกค้าคำสั่งซื้อเดิมซ้ำผ่านช่องทางควบคุมได้ แต่ไม่ควรใช้สต็อกอีกชิ้น การส่งอีเมลซ้ำต่างจากออกสินค้าใหม่ ต้องแยกสิทธิ์และประวัติตรวจสอบในระบบจัดการ
เก็บประวัติคืนเงินและกระทบยอดทั้งหมด ไม่ลบประวัติชำระเงิน
คืนเงินเป็นเหตุการณ์อิสระ อาจมีสถานะยื่นเรื่อง สำเร็จ ล้มเหลว หรือบางส่วน ไม่สื่อด้วยลบคำสั่งซื้อหรือกลับเป็นยังไม่จ่าย เก็บธุรกรรมเดิม หมายเลขคืนเงิน ยอด และผู้ดำเนินการ แล้วตรวจเทียบผลสุดท้ายฝั่งชำระ
สินค้าดิจิทัลถูกเปิดดูหรือแลกแล้วมีผลต่อบริการหลังขาย แต่ไม่ได้หมายความว่าคืนอัตโนมัติหรือเอากลับสต็อกได้ตามใจ รหัสที่ยกเลิกไม่ได้ต้องไม่กลับเป็นพร้อมขายหลังคืนเงิน รหัสยกเลิกได้ก็ต้องยืนยันผลยกเลิกก่อนตัดสินใจ
เทียบบันทึกชำระกับคำสั่งซื้อที่จ่ายแล้วเป็นระยะ หาแถวหาย ยอดผิด จ่ายแต่ยังไม่ส่ง และคืนไม่เสร็จ แจ้งบนเชนต้องผูกกับคำสั่งซื้อเฉพาะ ไม่เดาเจ้าของจากยอดเท่ากันอย่างเดียว เงื่อนไขยืนยันและธุรกรรมพิเศษต้องตกลงตอนเชื่อมต่อ
ตรวจสถานการณ์ล้มเหลวก่อนเปิดจริง และกำหนดขอบเขต API
- ข้อความปลอม ลายเซ็นผิด ร้านค้าผิด และยอดผิด ต้องไม่ก่อให้ส่งมอบ
- เหตุการณ์ซ้ำหรือหลายเหตุการณ์ของธุรกรรมเดียว ต้องไม่จัดสรรซ้ำ
- ซื้อชิ้นสุดท้ายพร้อมกัน ต้องมีบันทึกจัดสรรที่ใช้ได้เพียงหนึ่ง
- commit ล้มเหลวต้องไม่ตอบสำเร็จ หลัง commit แล้วรีสตาร์ตต้องทำต่อได้
- อีเมล timeout งานหยุด และผล API ภายนอกไม่ทราบ ต้องมีช่องตรวจสอบ
- ของขาด จ่ายช้า คืนเงิน และส่งเพิ่มด้วยคน ต้องมีสถานะติดตามได้
ระบบร้านค้าหลังบ้านของ 稳付pay ยังพัฒนาอยู่ แต่บริการเฝ้าดูและแจ้งกลับเปิดแล้ว ปัจจุบัน USDT รองรับ Tron (TRC20) และ Ethereum (ERC20) เงินตรงเข้าที่อยู่ของร้านค้าเอง เมื่อครบเงื่อนไขยืนยันบนเชนที่กำหนดจะส่งแจ้งธุรกิจระดับวินาที ไม่ได้หมายว่าบล็อกยืนยันในไม่กี่วินาที
บทความนี้ไม่ให้ URL API ส่วนหัวลายเซ็น หรือวิธีรับคีย์จริงของ 稳付pay ก่อนเชื่อมต่อโปรด ติดต่อยืนยันโปรโตคอลจริง แล้วทำการตรวจคำขอ ตอบรับ และกู้คำสั่งซื้อตามนั้น ทดสอบก่อนเปิดจริง
แหล่งอ้างอิงและเอกสารเทคนิค
แหล่งทางการต่อไปนี้ใช้ตรวจโปรโตคอลและหลักการ ตัวอย่างโค้ดและสถานการณ์มีเพื่ออธิบายเทคนิค ต้องทดสอบสภาพแวดล้อมกับข้อตกลงใช้งานจริงแยกกัน
พัฒนาเว็บไซต์ของคุณต่อ
ตั้งแต่เครือข่าย คำสั่งซื้อ จนถึงแจ้งเงิน ตรวจแต่ละขั้นตามธุรกิจ หากต้องเชื่อมต่อชำระเงินหรือเฝ้าดู USDT ติดต่อผ่านหน้าติดต่อ
ติดต่อ 稳付pay ↗