คู่มือนักพัฒนา: เชื่อมต่อ 稳付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 | จับคู่วิธีชำระเงิน | รหัสช่องทางจริงหรือรหัสรวมที่เปิดให้ผู้ค้ารายนี้ |
notifyUrl | API หลังบ้าน HTTPS ที่เข้าถึงสาธารณะ | เช่น https://merchant.example.com/pay/notify。 |
เก็บกุญแจเฉพาะหลังบ้าน หน้าเว็บรับเพียงคำสั่งซื้อธุรกิจและลิงก์ชำระเงินที่อนุญาตให้แสดง แยกการตั้งค่าทดสอบกับใช้งานจริง และปกปิดกุญแจรวมถึงส่วนกุญแจในข้อความก่อนลงลายเซ็นเมื่อบันทึก log
ขั้นที่ 2: เชื่อมกระบวนการชำระเงินทั้งหมด
- สร้างคำสั่งซื้อในระบบธุรกิจเซิร์ฟเวอร์กำหนดสินค้า จำนวนเงิน สกุลเงิน และหมายเลขคำสั่งซื้อผู้ค้าเฉพาะ แล้วบันทึกรอชำระ
- เซิร์ฟเวอร์ลงลายเซ็นสร้างคำสั่งซื้อสร้างเวลาปัจจุบันหน่วยมิลลิวินาที คำนวณลายเซ็น และเรียก API สร้างรับชำระแทน
- แสดงลิงก์ชำระเงินที่ใช้ได้ตรวจ payUrl ที่ส่งกลับจริงก่อนนำลูกค้าไปชำระ หากไม่มีลิงก์ให้เข้าสู่การสอบถามหรือจัดการข้อผิดพลาด
- ตรวจการแจ้งสำเร็จหลังบ้านตรวจลายเซ็น ผู้ค้า คำสั่งซื้อ สกุลเงิน และจำนวนเงิน ไม่ตัดสินว่าเงินเข้าจากการเปลี่ยนหน้าเบราว์เซอร์
- อัปเดตและส่งมอบแบบป้องกันผลซ้ำบันทึกสถานะชำระเงินถาวร ใช้บันทึกส่งมอบเฉพาะเพื่อไม่ส่งรหัส เติมเงิน หรือจัดส่งซ้ำ
- สอบถามและตรวจสอบสอบถามเชิงรุกเมื่อหมดเวลารอ การแจ้งขาดหาย หรือรอชำระนาน และเก็บบันทึกประมวลผล
ขั้นที่ 3: เตรียมจุดเชื่อมต่อสี่แห่งในผลิตภัณฑ์
| ตำแหน่งในระบบ | หน้าที่เชื่อมต่อ | บันทึกที่เก็บ |
|---|---|---|
| บริการสร้างคำสั่งซื้อ | ตรวจคำสั่งซื้อธุรกิจ ลงลายเซ็น และเรียก API สร้าง | หมายเลขคำสั่งซื้อผู้ค้า ยอดหน่วยเฟิน สกุลเงิน และหมายเลขคำสั่งซื้อแพลตฟอร์ม |
| หน้าแสดงการชำระเงิน | แสดงลิงก์ชำระจริงและสถานะในระบบ | เชื่อมคำสั่งซื้อกับสิทธิ์เข้าถึงของลูกค้า |
| API รับการแจ้งแบบอะซิงโครนัส | ตรวจลายเซ็น ตรวจข้อมูล และบันทึกผลสำเร็จถาวรแบบป้องกันผลซ้ำ | สรุปการแจ้ง ผลตรวจสอบ และเวลารับ |
| งานสอบถามคำสั่งซื้อ | เติมผลที่ไม่ชัดเจนและใช้กระบวนการส่งมอบเดียวกัน | ผลสอบถาม จำนวนครั้ง และเวลาตรวจล่าสุด |
เมื่อใช้แพลตฟอร์มส่งรหัสดิจิทัลสำเร็จรูป ให้นำตรรกะเหล่านี้เข้าในปลั๊กอินชำระเงินหรือส่วนขยายหลังบ้าน ยืนยันว่าเก็บหมายเลขคำสั่งซื้อผู้ค้าแยก ตรวจลายเซ็นจากพารามิเตอร์ต้นฉบับ และส่งมอบแบบป้องกันผลซ้ำได้ การเพิ่มลิงก์เปลี่ยนหน้าอย่างเดียวยังไม่ถือว่าเชื่อมต่อเสร็จ
รายการตรวจรับการเชื่อมต่อก่อนเปิดใช้งาน
- ทำคำสั่งซื้อทดสอบตามตกลง ส่งยอดสร้างเป็นหน่วยเฟิน และเชื่อมกับคำสั่งซื้อแพลตฟอร์มและทางเข้าชำระเงินที่ถูกต้อง
- ลายเซ็นถูกต้องต้องผ่าน ส่วนช่องข้อมูลขาด ยอดถูกแก้ และลายเซ็นผิดต้องตรวจพบและบันทึกได้
- แม้ผู้ใช้ปิดเบราว์เซอร์ เซิร์ฟเวอร์ยังอัปเดตสถานะผ่านการแจ้งหรือสอบถามได้
- เมื่อมีการแจ้งซ้ำ หรือ callback กับสอบถามยืนยันพร้อมกัน ต้องส่งมอบเพียงครั้งเดียว
- สร้างคำสั่งซื้อหมดเวลารอให้สอบถามรายการเดิมก่อน ไม่เปลี่ยนหมายเลขแล้วสร้างใหม่โดยไม่ตรวจ ผลไม่ชัดให้รอยืนยัน
- ชำระสำเร็จแต่ส่งมอบล้มเหลวต้องลองใหม่ได้ปลอดภัย และมีบันทึกทั้งการชำระเงินกับส่งสินค้า
- API รับการแจ้งเข้าถึงได้จากอินเทอร์เน็ต กุญแจไม่อยู่ในซอร์สหน้าเว็บ ไฟล์แนบสาธารณะ หรือ log
ฝ่ายเทคนิคยืนยันวงเงินทดสอบ สิทธิ์ช่องทาง และการจัดการปัญหากับคุณ หากต้องการความช่วยเหลือให้ส่งหมายเลขคำสั่งซื้อที่ปกปิดข้อมูล เวลาเรียก และสรุปข้อผิดพลาด ไม่แสดงกุญแจในภาพหน้าจอ
ดำเนินการเชื่อมต่อ API ต่อ
อ่านตามลำดับ สร้างและสอบถามรับชำระแทน、กฎลายเซ็นคำขอ และ ตรวจลายเซ็น callback และส่งมอบแบบป้องกันผลซ้ำ ฝ่ายเทคนิคช่วยเชื่อมต่อตามเฟรมเวิร์ก ระบบส่งรหัส และช่องทางที่คุณเปิดใช้แล้ว
บทความนี้เรียบเรียงตามข้อกำหนดเชื่อมต่อ 稳付pay ตัวอย่างอธิบายตำแหน่งเรียกและโครงสร้างพารามิเตอร์ การทดสอบเชื่อมต่อจริงใช้การตั้งค่าที่จัดสรรให้คุณ
ยืนยันการเชื่อมต่อให้ตรงธุรกิจของคุณ
แจ้งสินค้า ปริมาณคำสั่งซื้อ วิธีชำระเงิน และความต้องการชำระยอด เพื่อยืนยัน API เส้นทางเงิน และการจัดการปัญหาทีละข้อ
ติดต่อ 稳付pay ↗