เชื่อมต่อการเติมเงิน

ขั้นตอนเชื่อมต่อเติมเงินผ่าน Alipay: เติมเงินเว็บไซต์และแอป Callback และบัญชียอดคงเหลือ

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

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

1. แยกการเติมเงินของผู้ใช้ การรับชำระ และการบันทึกบัญชี

ผู้ใช้เติมยอดในระบบร้านค้า ไม่ได้เติมเงินเข้ากระเป๋า Alipay โดยตรง 稳付pay รับผิดชอบช่องทางรับชำระ Alipay แบบ Native ที่เปิดแล้ว การยืนยันผลชำระ และการแจ้ง ส่วนร้านค้าดูแลบัญชีผู้ใช้ รายการยอดคงเหลือ บันทึกใช้จ่าย และกฎบริการหลังการขาย

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

2. การเติมเงินผ่าน Alipay หนึ่งครั้งเสร็จอย่างไร

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

3. กำหนดผู้ใช้ ยอด และการตั้งค่าช่องทาง

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

ตาม เอกสารสร้างและสอบถามคำสั่งซื้อรับชำระ ระบุพารามิเตอร์ เช่น mchId, wayCode, outTradeNo, amount, notifyUrl, reqTime และ sign โดย amount ใช้หน่วยเฟิน เช่น 1000 คือ 10.00 หยวน และ reqTime ใช้ timestamp ปัจจุบันหน่วยมิลลิวินาที รหัสช่องทางรวม Alipay คือ 80001 ใช้ได้เมื่อร้านค้าได้รับสิทธิและเปิดช่องทางจริงแล้วเท่านั้น

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

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

4. ตรวจ callback ตามโปรโตคอล稳付pay

ตาม กฎลายเซ็น และ เอกสาร callback เพื่อจัดการ sign ใน Body สำหรับ callback ให้ใช้ CALLBACK_SECRET ก่อน หากไม่ได้ตั้งแยกจึงใช้ MD5_SECRET เรียงและต่อฟิลด์ที่ไม่ว่างจริงก่อนคำนวณ MD5 ตัวพิมพ์เล็ก เก็บสตริงเดิม เช่น 00 และ 10.00 อย่าแปลงเป็น 0 หรือ 10 ก่อนตรวจลายเซ็น และเก็บกุญแจบนเซิร์ฟเวอร์เท่านั้น

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

API รวมบนเว็บไซต์นี้ต่างจากโปรโตคอลเชื่อมตรงของ Alipay การทำงานของ Alipay โค้ดลายเซ็น RSA2 ใน SDK ทางการ ใช้แทนกฎ MD5 ที่นี่ไม่ได้ และอย่านำตัวอย่างตอบ success จากที่อื่นมาแทนขั้นตอนในบทความ Callback มาตรฐานของ稳付payแนะนำให้ตอบ HTTP 200 พร้อมข้อความธรรมดา OK หลังบันทึกอย่างเชื่อถือได้แล้ว

5. ป้องกันยอดคงเหลือด้วยรายการบัญชีเฉพาะ

สร้าง unique constraint ในฐานข้อมูลให้รายการเติมเงิน เช่น “ร้านค้า + คำสั่งซื้อเติมเงิน” ต้อง commit คำสั่งซื้อ บันทึกชำระ รายการเติม และยอดที่เปลี่ยนในธุรกรรมเดียวกัน ห้ามเพิ่มยอดก่อนแล้วค่อยเขียนว่า “จัดการแล้ว” แยกภายหลัง การปิดปุ่มบนหน้าเว็บหรือเช็กว่ามีรายการแล้วค่อยเขียนอย่างเดียวป้องกันการแจ้งที่เข้าพร้อมกันไม่ได้

ตรวจการแจ้งและเทียบคำสั่งซื้อเติมเงินที่เก็บไว้
เริ่มธุรกรรมฐานข้อมูล
  ล็อกคำสั่งซื้อและบัญชีที่เกี่ยวข้อง
  หากมีรายการเติมสำเร็จของคำสั่งซื้อนี้แล้ว: ไม่เพิ่มยอดอีก
  หากยังไม่มี: เก็บรายการเฉพาะ เพิ่มยอดให้ผู้ใช้ที่ถูกต้อง อัปเดตคำสั่งซื้อ
Commit ธุรกรรม
ตอบ HTTP 200 พร้อมข้อความธรรมดา OK

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

6. เมื่อหมดเวลาหรือแจ้งซ้ำ ให้ตรวจคำสั่งซื้อเดิมก่อน

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

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

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

7. แยกกระทบยอดเติมเงินผู้ใช้กับ USDT ที่ชำระให้ร้านค้า

ยอดผู้ใช้ที่เพิ่มหมายถึงระบบบัญชีร้านค้าบันทึกเสร็จ ส่วนการชำระยอด USDT ให้ร้านค้าเสร็จหมายถึงเงินที่เกี่ยวข้องถูกชำระไปยังที่อยู่รับตามข้อตกลง บันทึกสองชั้นนี้ต้องไม่ใช้สถานะ “เสร็จสิ้น” เดียวกัน

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

8. คำถามที่พบบ่อยและตรวจรับก่อนเปิดใช้

ปิดหน้าหลังชำระแล้ว ยังเติมเงินสำเร็จได้หรือไม่?

หลังบ้านดำเนินการต่อตามการแจ้งที่ถูกต้องหรือผลสอบถามได้ ไม่ต้องรอผู้ใช้กลับหน้าเว็บ ร้านค้าต้องทำบัญชีและการชดเชยให้เชื่อถือได้

มีเติมเงินผ่าน WeChat อยู่แล้ว ใช้ยอดคงเหลือร่วมกันได้หรือไม่?

ใช้บัญชียอดคงเหลือร่วมในระบบร้านค้าได้ แต่คำสั่งซื้อต้องเก็บวิธีชำระและช่องทางเดิม การชำระหนึ่งครั้งมีรายการเติมที่ใช้ได้เพียงรายการเดียว

ปลั๊กอิน Alipay สำเร็จรูปเปลี่ยน URL ก็เชื่อมได้เลยหรือไม่?

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

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

แหล่งอ้างอิง

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

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

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

ติดต่อ 稳付pay ↗