ปฏิบัติการเชื่อมต่อ

ขั้นตอนเชื่อมต่อแพลตฟอร์มส่งรหัสดิจิทัลโดยละเอียด: ตั้งค่าสินค้า ตรวจรับ callback การชำระเงิน และส่งมอบอัตโนมัติ

เมื่อเตรียมสินค้า โดเมน และโปรแกรมส่งรหัสแล้ว จะทำให้ลูกค้าได้รับรหัสสิทธิ์ของตนอย่างเชื่อถือได้หลังชำระเงินอย่างไร บทความนี้เรียงการเตรียม พัฒนา ทดสอบร่วม และเปิดใช้งานตามกระบวนการเชื่อมต่อครบครั้ง ตัวอย่างสำหรับสินค้าดิจิทัลของตนเองหรือได้รับสิทธิ์แล้ว ชื่อช่องและรหัสเทียมอธิบายการจับคู่เท่านั้น ไม่ใช่เอกสาร API จริงของ 稳付pay

เตรียมเชื่อมต่อ 稳付pay: โปรดดู เอกสารนักพัฒนารับชำระแทน ใช้ช่องข้อมูลจริงทำลายเซ็น MD5 สร้าง สอบถาม และจัดการ callback เกตเวย์ผู้ค้ากับกุญแจจะให้แยกโดยฝ่ายเทคนิค API จ่ายเงินแทนยังไม่เปิดให้ใช้
สารบัญบทความ

ขั้นที่ 1: แบ่งหน้าที่สินค้า การชำระเงิน และส่งมอบให้ชัด

กำหนดสามขอบเขตก่อน: ระบบส่งรหัสดูแลสินค้า คำสั่งซื้อ และส่งมอบ บริการชำระเงินระบุธุรกรรมและแจ้งผล ส่วนชำระยอดส่งเงินที่ต้องจ่ายให้ผู้ค้าตามตกลง ชำระเงินสำเร็จ ส่งสินค้าแล้ว และเงินชำระยอดเข้าแล้วเป็นข้อเท็จจริงสามอย่าง ห้ามรวมเป็นสวิตช์ “เสร็จ” เดียวกัน

  1. เตรียมสินค้ากำหนด SKU สต็อก และกฎหลังการขาย
  2. สร้างการชำระเงินหลังบ้านกำหนดยอดคำสั่งซื้อและความพยายามชำระให้แน่นอน
  3. ตรวจยืนยันการชำระเงินใช้ callback ที่เชื่อถือได้ร่วมกับสอบถามจากเซิร์ฟเวอร์
  4. ส่งมอบอัตโนมัติจัดสรรในธุรกรรมและลองงานที่บันทึกถาวรใหม่
ส่งมอบตามผลชำระเงินที่เชื่อถือได้ บันทึกและตรวจความคืบหน้าชำระยอดผู้ค้าแยกต่างหาก

เช่นขายรหัสเปิดใช้ซอฟต์แวร์ที่พัฒนาเอง คำสั่งซื้ออาจชำระแล้ว รอส่ง และยังไม่เข้ารอบชำระยอดปัจจุบัน หากลูกค้าจ่ายแล้วแต่ไม่ได้สินค้าตลอดเพราะคิวชำระยอดยังไม่เสร็จ มักแปลว่าระบบผูกเส้นทางเหล่านี้ผิด

ขั้นที่ 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 และสภาพแวดล้อมใช้งานจริง

  1. OWASP: ความปลอดภัยในการเชื่อมต่อระบบชำระเงินภายนอก
  2. Stripe: การตรวจ Webhook การลองใหม่ และเหตุการณ์ซ้ำ
  3. Stripe: คำขอแบบ idempotent
  4. PostgreSQL: ธุรกรรม
  5. PostgreSQL: การล็อกแถวและการทำงานพร้อมกัน
  6. PostgreSQL: ข้อจำกัดไม่ให้ค่าซ้ำ

ยืนยันการเชื่อมต่อให้ตรงธุรกิจของคุณ

แจ้งสินค้า ปริมาณคำสั่งซื้อ วิธีชำระเงิน และความต้องการชำระยอด เพื่อยืนยัน API เส้นทางเงิน และการจัดการปัญหาทีละข้อ

ติดต่อ 稳付pay ↗