ขั้นตอนเชื่อมต่อแพลตฟอร์มส่งรหัสดิจิทัลโดยละเอียด: ตั้งค่าสินค้า ตรวจรับ callback การชำระเงิน และส่งมอบอัตโนมัติ
เมื่อเตรียมสินค้า โดเมน และโปรแกรมส่งรหัสแล้ว จะทำให้ลูกค้าได้รับรหัสสิทธิ์ของตนอย่างเชื่อถือได้หลังชำระเงินอย่างไร บทความนี้เรียงการเตรียม พัฒนา ทดสอบร่วม และเปิดใช้งานตามกระบวนการเชื่อมต่อครบครั้ง ตัวอย่างสำหรับสินค้าดิจิทัลของตนเองหรือได้รับสิทธิ์แล้ว ชื่อช่องและรหัสเทียมอธิบายการจับคู่เท่านั้น ไม่ใช่เอกสาร API จริงของ 稳付pay
สารบัญบทความ
ขั้นที่ 1: แบ่งหน้าที่สินค้า การชำระเงิน และส่งมอบให้ชัด
กำหนดสามขอบเขตก่อน: ระบบส่งรหัสดูแลสินค้า คำสั่งซื้อ และส่งมอบ บริการชำระเงินระบุธุรกรรมและแจ้งผล ส่วนชำระยอดส่งเงินที่ต้องจ่ายให้ผู้ค้าตามตกลง ชำระเงินสำเร็จ ส่งสินค้าแล้ว และเงินชำระยอดเข้าแล้วเป็นข้อเท็จจริงสามอย่าง ห้ามรวมเป็นสวิตช์ “เสร็จ” เดียวกัน
- เตรียมสินค้ากำหนด SKU สต็อก และกฎหลังการขาย
- สร้างการชำระเงินหลังบ้านกำหนดยอดคำสั่งซื้อและความพยายามชำระให้แน่นอน
- ตรวจยืนยันการชำระเงินใช้ callback ที่เชื่อถือได้ร่วมกับสอบถามจากเซิร์ฟเวอร์
- ส่งมอบอัตโนมัติจัดสรรในธุรกรรมและลองงานที่บันทึกถาวรใหม่
เช่นขายรหัสเปิดใช้ซอฟต์แวร์ที่พัฒนาเอง คำสั่งซื้ออาจชำระแล้ว รอส่ง และยังไม่เข้ารอบชำระยอดปัจจุบัน หากลูกค้าจ่ายแล้วแต่ไม่ได้สินค้าตลอดเพราะคิวชำระยอดยังไม่เสร็จ มักแปลว่าระบบผูกเส้นทางเหล่านี้ผิด
ขั้นที่ 2: เตรียมสินค้า สต็อก และสภาพแวดล้อมให้พร้อม
กำหนดรหัสสินค้าคงที่ให้แต่ละรุ่น ระบุอายุสิทธิ์ รุ่นที่รองรับ จำนวนสูงสุด รูปแบบส่งมอบ และช่องทางหลังการขาย ราคาที่แสดงกับราคาคิดที่เซิร์ฟเวอร์ต้องมาจากข้อมูลน่าเชื่อถือเดียวกัน อย่าให้เบราว์เซอร์กำหนดยอดที่ต้องจ่ายเอง
แยกสต็อกเป็นพร้อมขาย สำรอง จัดสรรแล้ว และส่งมอบแล้ว การสำรองต้องมีอายุและเงื่อนไขคืนแบบอะตอมมิก เวลารอชำระกับสำรองต้องสอดคล้อง คำสั่งซื้อยืนยันชำระแล้วห้ามถูกเปลี่ยนเป็นยังไม่ชำระและคืนสต็อกไร้เงื่อนไขเพียงเพราะงานหมดอายุรัน
สภาพแวดล้อมจริงอย่างน้อยต้องมี HTTPS ที่ใช้ได้ การตั้งค่าทดสอบแยก ฐานข้อมูลเชื่อถือได้ โปรเซสงานถาวร และวิธีสำรองกู้คืน แสดงรหัสเฉพาะผู้ใช้ที่มีสิทธิ์ในคำสั่งซื้อนั้น Log เข้าถึงและสแต็กข้อผิดพลาดห้ามเก็บรหัสเต็ม กุญแจส่วนตัว หรือกุญแจชำระเงิน
ขั้นที่ 3: ยืนยันความสามารถเชื่อมต่อก่อนทำตารางจับคู่ช่องข้อมูล
ยืนยันข้อกำหนดจริงทีละข้อ: การรับรองตัวตน ขอบเขตลายเซ็น ข้อกำหนดข้อความดิบ ความสามารถสอบถาม สถานะชำระเงิน การตอบรับแจ้ง วิธีลองใหม่ เขตเวลา และความละเอียดเงิน หากปลั๊กอินสำเร็จรูปไม่ตรง ให้แก้ชั้นเชื่อมต่อ อย่าใช้การแก้เทมเพลตหน้าเว็บแทนการเชื่อมการชำระเงิน
| ข้อมูลธุรกิจในระบบ | ตรวจตอนเชื่อมต่อ | วัตถุประสงค์ที่บันทึก |
|---|---|---|
| หมายเลขคำสั่งซื้อผู้ค้า | ความยาว อักขระ และขอบเขตความไม่ซ้ำ | เชื่อมสินค้า การชำระเงิน และส่งมอบตลอดเส้นทาง |
| หมายเลขความพยายามชำระ | ระบุการลองใหม่ในคำสั่งซื้อเดียวอย่างไร | ไม่สร้างซ้ำหลังหมดเวลารอ |
| ยอดที่ต้องชำระ สกุลเงิน | หน่วย ความละเอียด และสถานะที่อนุญาต | ป้องกันจ่ายขาดหรือสกุลเงินไม่ตรง |
| หมายเลขธุรกรรมช่องทางและเหตุการณ์ | มีหรือไม่ ขอบเขต และวิธีสอบถาม | ระบุเจ้าของเงินและตัดการแจ้งซ้ำ |
| ที่อยู่ callback และที่อยู่กลับ | ความต่างระหว่างแจ้งเซิร์ฟเวอร์กับเปลี่ยนหน้าเบราว์เซอร์ | แยกยืนยันธุรกิจออกจากแสดงความคืบหน้า |
| เครือข่าย สินทรัพย์ และที่อยู่รับ | เครือข่ายและตัวระบุสินทรัพย์ USDT | ป้องกันเข้าใจผิดข้ามเชนหรือโทเคนชื่อเหมือนกัน |
ชื่อในตารางเป็นเพียงแนวคิดธุรกิจ ช่องข้อมูลและวิธีลงลายเซ็นสุดท้ายต้องอิงเอกสารจริงที่สองฝ่ายยืนยัน อย่าคัดลอกบทความนี้เป็นรูปแบบคำขอ
ขั้นที่ 4: สร้างคำสั่งซื้อหลังบ้านและเก็บทุกความพยายามชำระ
หลังผู้ใช้เลือกสินค้า เซิร์ฟเวอร์อ่านราคาใหม่ ตรวจสต็อกและข้อจำกัด สร้างหมายเลขคำสั่งซื้อผู้ค้า เก็บภาพยอด สกุลเงิน และวันหมดอายุ บันทึกความพยายามชำระก่อนเรียกบริการ เพื่อยังค้น “คำขอครั้งนี้” ได้หลังเครือข่ายขัดข้อง
คำขอสร้างหมดเวลารอหมายถึงยังไม่ได้คำตอบชัด ไม่ใช่บริการยังไม่สร้างสำเร็จ ตรวจหมายเลขคำสั่งซื้อผู้ค้าเดิมหรือเงื่อนไขสอบถามที่ตกลงก่อน จะลองใหม่อย่างปลอดภัยด้วยธุรกิจเดิมและคีย์ป้องกันซ้ำที่ตกลงได้ก็ต่อเมื่อข้อกำหนดผู้ให้บริการรองรับ ดู คำอธิบายคำขอแบบป้องกันผลซ้ำของ Stripe เพื่อเข้าใจกลไกนี้ ห้ามสมมติว่าทุกช่องทางรองรับส่วนหัวคำขอแบบเดียวกัน
เมื่อลูกค้าเลือกวิธีชำระเงินใหม่ ต้องเก็บความเชื่อมโยงของความพยายามชำระเดิมไว้ เพื่อไม่ให้การแจ้งผลเดิมถูกนำไปจับคู่กับคำสั่งซื้อของช่องทางใหม่ หากเกิดการชำระเงินจริงสองครั้ง ให้บันทึกแยกกันและเข้าสู่กระบวนการจัดการชำระซ้ำ ไม่ควรส่งสินค้าสองชุดเพื่อกลบปัญหา
ขั้นที่ 5: แสดงคำแนะนำชำระเงิน หน้ากลับแสดงเพียงความคืบหน้า
ส่งลิงก์ชำระเงินหรือพารามิเตอร์ที่จำเป็นซึ่งเซิร์ฟเวอร์ได้รับให้ส่วนหน้า แสดงเลขคำสั่งซื้อ จำนวนเงิน วันหมดอายุ และช่องทางบริการหลังการขาย เมื่อรับ USDT ต้องแสดงเครือข่ายและที่อยู่รับเงินให้ถูกต้อง ไม่ควรระบุเพียง “USDT” แล้วให้ลูกค้าเดาเครือข่ายเอง
การที่ลูกค้ากลับมายังเว็บไซต์หลังชำระ ปิดหน้าเว็บ หรือเปลี่ยนอุปกรณ์ ต้องไม่เปลี่ยนกระบวนการยืนยันฝั่งเซิร์ฟเวอร์ หน้ากลับมายังร้านค้าควรสอบถามความคืบหน้าจากระบบหลังบ้านของตนเอง และไม่ส่งมอบสินค้าจากพารามิเตอร์ success ใน URL โดยตรง การดูรายละเอียดคำสั่งซื้อและรหัสสินค้าต้องตรวจสอบตัวตนหรือหลักฐานเข้าถึงคำสั่งซื้อที่คาดเดาได้ยาก
แนวทางบูรณาการระบบชำระเงินจากภายนอกของ OWASP เน้นการตรวจสอบฝั่งเซิร์ฟเวอร์และการจับคู่จำนวนเงิน ข้อความ “ส่งรายการแล้ว” และ “กำลังยืนยัน” ต้องแยกจาก “ชำระแล้ว” เพื่อไม่ให้รายงานการโอนที่ยังไม่ได้ยืนยันว่าเป็นรายการสำเร็จ
ขั้นที่ 6: หลังบ้านตรวจลายเซ็น สอบถาม และตรวจช่องข้อมูลธุรกิจ
เมื่อต้องรับการแจ้งผล ให้ตรวจสอบลายเซ็นตามโพรโทคอลจริง พร้อมตรวจร้านค้า คำสั่งซื้อ จำนวนเงิน สกุลเงิน และสถานะสำเร็จ หากโพรโทคอลต้องใช้เนื้อหาคำขอต้นฉบับ ให้เก็บไบต์เดิมก่อนแปลงหรือเขียนข้อมูลใหม่ ลายเซ็นที่ถูกต้องไม่ได้ทดแทนการตรวจสอบข้อมูลธุรกิจ
ใช้การสอบถามสถานะฝั่งเซิร์ฟเวอร์ที่ผ่านการยืนยันตัวตนตามรูปแบบการเชื่อมต่อ โดยเฉพาะเมื่อไม่มี callback การสร้างรายการหมดเวลา หรือสถานะขัดแย้งกัน หากสอบถามไม่ได้ชั่วคราว ให้คงสถานะรอยืนยันและจัดคิวลองใหม่ ไม่ตีความปัญหาเครือข่ายว่า “ล้มเหลวแล้ว” และไม่ส่งสินค้าจากภาพหลักฐานการชำระโดยอัตโนมัติ
เอกสาร Webhook ของ Stripe อธิบายการตรวจสอบการแจ้งผล การส่งซ้ำ และการมาถึงผิดลำดับ การตอบรับว่ารับการแจ้งผลสำเร็จต้องเป็นไปตามโพรโทคอล และต้องบันทึกเหตุการณ์กับภาระงานต่อเนื่องอย่างคงทนแล้ว หากตอบรับก่อนแต่เก็บงานไว้เพียงในหน่วยความจำ การรีสตาร์ตโปรเซสอาจทำให้คำสั่งซื้อสูญหายจากการประมวลผล
ขั้นที่ 7: บันทึกเงินกับสต็อกในธุรกรรม ส่งแบบอะซิงโครนัสหลัง commit
ข้อเท็จจริงการชำระ การจัดสรรสต็อก และงานส่งสินค้าต้องบันทึกร่วมกันได้ ใช้การล็อกแถวหรืออัปเดตแบบอะตอมที่มีเงื่อนไขสถานะกับคำสั่งซื้อเดียวกัน และกำหนดข้อจำกัดไม่ให้ซ้ำสำหรับเหตุการณ์ ธุรกรรม และการส่งมอบตามขอบเขตที่เหมาะสม การจัดสรรสต็อกต้องมีเจ้าของเพียงรายเดียวตามรายการสินค้าในคำสั่งซื้อและจำนวนที่ซื้อ การประมวลผลซ้ำต้องคืนผลการจัดสรรเดิม ไม่ดึงรหัสใหม่เพียงเพราะงานส่งมอบยังไม่เสร็จ การตรวจว่ามีหรือไม่แล้วค่อยเขียนอย่างเดียวไม่ป้องกันการแข่งขันพร้อมกัน
# Protocol mapping example, not a runnable payment integration.
event = verify_using_confirmed_protocol(raw_request)
payment = query_and_match_payment(event)
with database_transaction():
lock_order(payment.order_id)
persist_verified_event_once(event)
record_payment_once(payment)
if not fulfillment_exists(payment.order_id):
if allocate_or_reuse_stock_once(payment.order_id):
create_outbox_job_once(payment.order_id, "deliver")
else:
mark_paid_awaiting_stock(payment.order_id)
create_outbox_job_once(payment.order_id, "stock_review")
return acknowledgement_required_by_protocol()
คำอธิบายธุรกรรมของ PostgreSQL ช่วยให้เข้าใจการ commit ร่วมกัน ส่วน กลไกการล็อกแถว ใช้ประสานการแข่งขันของข้อมูล ควรทำการสอบถามระบบภายนอกและส่งอีเมลนอกธุรกรรมระยะสั้น Outbox คือระเบียนงานที่บันทึกพร้อมข้อมูลธุรกิจ และให้ worker ทำต่อหลัง commit ตัวอย่างละรายละเอียดการดักข้อผิดพลาดไว้ ระบบจริงยังต้องจัดการคีย์ซ้ำ deadlock และการลองใหม่หลังล้มเหลว
ขั้นที่ 8: เพิ่มทางจัดการสต็อกหมด เงินเข้าช้า และคืนเงิน
หากยืนยันการชำระแล้วแต่สต็อกหมด ให้บันทึก “ชำระแล้ว รอดำเนินการ” และแจ้งผู้ดูแลให้เติมสต็อก ตกลงส่งมอบ หรือคืนเงิน ไม่เปลี่ยนกลับเป็น “ยังไม่ชำระ” คำสั่งซื้อหมดอายุที่มีเงินเข้าภายหลังอย่างถูกต้องก็ต้องบันทึกการชำระก่อน แล้วจัดการตามสต็อกและกติกาที่ตกลง ไม่ละทิ้งรายการโดยตรง
การส่งอีเมลหมดเวลาไม่ได้แปลว่ายังไม่ได้ส่ง งานส่งมอบต้องใช้รหัสเดิมอย่างสม่ำเสมอ เมื่อติดต่อบริการสิทธิ์ใช้งานภายนอกที่รองรับ idempotency ให้ใช้ตัวระบุเดิม หากไม่รองรับ ให้ตรวจสอบสถานะหรือให้เจ้าหน้าที่ตรวจสอบก่อน การส่งรหัสเดิมของคำสั่งซื้อซ้ำกับการจัดสรรรหัสใหม่เป็นคนละการกระทำ การส่งรหัสเดิมไม่ควรตัดสต็อกอีกครั้ง
การคืนเงินต้องมีสถานะขอคืน กำลังดำเนินการ สำเร็จ หรือล้มเหลวแยกต่างหาก และเชื่อมกับธุรกรรมเดิม รหัสสิทธิ์ที่แสดงหรือถูกใช้แล้วไม่ควรนำกลับมาขายทันที สิทธิ์ที่เพิกถอนได้ก็ต้องตรวจผลการเพิกถอนก่อน บันทึกผู้ดำเนินการ เหตุผล และเลขรายการที่เกี่ยวข้องของทุกการคืนเงินหรือส่งทดแทน
ขั้นที่ 9: ใช้ตารางตรวจรับพิสูจน์ว่ารับมือความผิดปกติได้
การทดสอบเชื่อมต่อไม่ควรมีเพียงรายการชำระปกติ เก็บเลขคำสั่งซื้อ รหัสความพยายามชำระ ผลตรวจสอบ ระเบียนการชำระ การจัดสรรสต็อก และสถานะงานสำหรับแต่ละกรณี เพื่อให้ผู้ดูแลอีกคนตรวจซ้ำได้
| ข้อมูลทดสอบ | ผลคำสั่งซื้อที่คาดหวัง | การตรวจรับการส่งมอบ |
|---|---|---|
| การชำระเงินจริงที่สำเร็จ | ชำระแล้วและตรวจสอบธุรกรรมได้ | จำนวนถูกต้อง ส่งมอบเพียงครั้งเดียว |
| ลายเซ็นหรือจำนวนเงินผิด | ไม่ยืนยันสำเร็จและบันทึกเหตุผล | ไม่จัดสรรสต็อก |
| การแจ้งผลเดียวกันมาถึงพร้อมกัน | บันทึกการรับชำระเดียวกันเพียงครั้งเดียว | มีการจัดสรรที่ใช้ได้เพียงหนึ่งชุด |
| สร้างรายการหมดเวลาและ callback ยังไม่มา | สอบถามเพื่อคืนสถานะที่ยืนยันได้ | ไม่ชำระซ้ำและไม่ตกหล่นการส่งสินค้า |
| มีคำสั่งซื้อแย่งสินค้าชิ้นสุดท้ายพร้อมกัน | เก็บข้อเท็จจริงการชำระของแต่ละรายการ | ไม่ขายเกินสต็อกและจัดการคำสั่งซื้อที่ขาดสินค้าได้ |
| เงินเข้าช้าและปิดหน้าเว็บไปแล้ว | เก็บข้อเท็จจริงว่าชำระแล้ว | ส่งทดแทนหรือดูแลหลังการขายตามกติกา |
| โปรเซสรีสตาร์ตหลัง commit | ระเบียนถาวรยังอยู่ | งานกลับมาทำต่อโดยไม่ส่งเกิน |
| เกิดการคืนเงินและส่งสินค้าพร้อมกัน | ติดตามสถานะแยกจากกันได้ | แก้ความขัดแย้งตามกติกาการประสานงาน |
หากผู้ให้บริการมีสภาพแวดล้อมทดสอบ ให้ใช้ก่อน หากไม่มี ต้องตกลงการชำระจริงจำนวนน้อย การคืนเงิน และค่าธรรมเนียมล่วงหน้า ขั้นตอนในบทความนี้ไม่ทดแทนการทดสอบกับช่องทางจริง และใช้เป็นหลักฐานว่า “ผ่านการตรวจรับแล้ว” ไม่ได้
ขั้นที่ 10: เปิดใช้วงจำกัด และยังจัดการคำสั่งซื้อเก่าเมื่อย้อนกลับ
ก่อนเผยแพร่ให้เก็บข้อมูลสำรองที่กู้คืนได้ ตัวเชื่อมต่อรุ่นเดิม และค่าตั้งเดิม พร้อมตรวจว่าโครงสร้างข้อมูลหลังเปลี่ยนสามารถย้อนกลับได้หรือไม่ เริ่มเชื่อมต่อในขอบเขตจำกัดและติดตามจำนวนรอยืนยัน การตรวจลายเซ็นล้มเหลว รายการชำระแล้วแต่ยังไม่ส่งสินค้า งานค้าง และความผิดปกติในการสอบถาม
เมื่อพบปัญหาอาจหยุดความพยายามชำระใหม่ แต่ควรรับและตรวจการแจ้งผลคำสั่งซื้อเดิมต่อ เก็บความเข้ากันได้กับโพรโทคอลเดิมและแผนเปลี่ยนคีย์ อย่า “ย้อนรุ่น” ด้วยการลบ URL callback หรือล้างคิว มิฉะนั้นการชำระเดิมอาจไม่ถูกเชื่อมเข้ากับคำสั่งซื้ออีกเลย
稳付pay รองรับการเชื่อมต่อ Alipay, WeChat Pay และช่องทางอื่น การชำระบัญชีเป็น USDT หลังรับเงินผ่านช่องทางเป็นไปตามข้อตกลงของทั้งสองฝ่าย ส่วนบริการติดตามที่อยู่ USDT ของร้านค้า ลูกค้าจ่ายตรงเข้ากระเป๋าร้านค้า ปัจจุบันรองรับ Tron (TRC20) และ Ethereum (ERC20) พร้อม callback ทางธุรกิจระดับวินาทีหลังครบเงื่อนไขยืนยันที่ตั้งไว้ ไม่ได้หมายความว่าบล็อกเชนยืนยันเสร็จในไม่กี่วินาที ระบบหลังบ้านร้านค้ายังอยู่ระหว่างพัฒนา โปรด ติดต่อเพื่อยืนยันโพรโทคอล เงื่อนไขการชำระบัญชี และขอบเขตทดสอบ แล้วจึงพัฒนาตัวเชื่อมต่อที่ตรงกัน
แหล่งอ้างอิงและเอกสารเทคนิค
เอกสารทางการใช้ตรวจสอบหลักการเทคนิคทั่วไป ตัวอย่างต้องตรวจร่วมกับเอกสาร API และสภาพแวดล้อมใช้งานจริง
ยืนยันการเชื่อมต่อให้ตรงธุรกิจของคุณ
แจ้งสินค้า ปริมาณคำสั่งซื้อ วิธีชำระเงิน และความต้องการชำระยอด เพื่อยืนยัน API เส้นทางเงิน และการจัดการปัญหาทีละข้อ
ติดต่อ 稳付pay ↗