เอกสารสำหรับนักพัฒนา

คู่มือนักพัฒนา: เชื่อมต่อ 稳付pay เข้าผลิตภัณฑ์ของคุณ

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

สารบัญบทความ

ยืนยันบริการที่ต้องการเชื่อมต่อก่อน

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

การชำระยอดหลังรับชำระแทนกับบริการเฝ้าดูบนเชนที่ลูกค้าจ่ายตรงสู่วอลเล็ต USDT ของผู้ค้าเป็นคนละเส้นทางธุรกิจ API รับชำระแทนชุดนี้ไม่ใช่ API รับ USDT ตรงบนเชน

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

ขั้นที่ 1: ขอการตั้งค่าผู้ค้า

รายการตั้งค่าตำแหน่งใช้งานสิ่งที่ต้องยืนยัน
API_BASE_URLเซิร์ฟเวอร์ผู้ค้าเกตเวย์จริงที่ได้รับจัดสรร บทความใช้ https://gateway.example.com เป็นตัวอย่าง
MERCHANT_IDเซิร์ฟเวอร์ผู้ค้าหมายเลขผู้ค้าของคุณ ชื่อช่องข้อมูลในคำขอคือ mchId。
MD5_SECRETตัวแปรสภาพแวดล้อมหรือระบบจัดการกุญแจกุญแจ API สำหรับสร้างและสอบถามคำสั่งซื้อ
CALLBACK_SECRETจัดการกุญแจบนเซิร์ฟเวอร์กุญแจ callback ที่ตั้งค่าแยก หากยังไม่กำหนดให้กลับไปใช้กุญแจ API
wayCodeจับคู่วิธีชำระเงินรหัสช่องทางจริงหรือรหัสรวมที่เปิดให้ผู้ค้ารายนี้
notifyUrlAPI หลังบ้าน HTTPS ที่เข้าถึงสาธารณะเช่น https://merchant.example.com/pay/notify。

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

ขั้นที่ 2: เชื่อมกระบวนการชำระเงินทั้งหมด

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

ขั้นที่ 3: เตรียมจุดเชื่อมต่อสี่แห่งในผลิตภัณฑ์

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

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

รายการตรวจรับการเชื่อมต่อก่อนเปิดใช้งาน

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

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

ดำเนินการเชื่อมต่อ API ต่อ

อ่านตามลำดับ สร้างและสอบถามรับชำระแทน、กฎลายเซ็นคำขอ และ ตรวจลายเซ็น callback และส่งมอบแบบป้องกันผลซ้ำ ฝ่ายเทคนิคช่วยเชื่อมต่อตามเฟรมเวิร์ก ระบบส่งรหัส และช่องทางที่คุณเปิดใช้แล้ว

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

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

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

ติดต่อ 稳付pay ↗