เชื่อมต่อ WeChat H5: เปิดหน้าชำระเงิน ตรวจคำสั่ง และเพิ่มยอดคงเหลือ
WeChat H5 เริ่มจากเว็บไซต์ในเบราว์เซอร์มือถือแล้วเปิดหน้าชำระเงิน WeChat ระบบที่ครบต้องเชื่อมการเปลี่ยนหน้ากับการยืนยันเงินฝั่งเซิร์ฟเวอร์และบัญชียอดคงเหลือ บทความอธิบายขั้นตอนทางการ หากใช้ 稳付pay ทีมเทคนิคต้องยืนยันการรองรับ H5 สิทธิ์ร้านค้า และ API จริงก่อน
อ่านต่อตามหัวข้อ
1. แยก H5 หน้าเว็บใน WeChat และ APP
H5 ทางการใช้กับเบราว์เซอร์มือถือที่อยู่นอกเบราว์เซอร์ภายใน WeChat หน้าเว็บใน WeChat โดยทั่วไปใช้ JSAPI ส่วนแอปเนทีฟใช้ APP การฝังเว็บในแอปไม่ได้ทำให้เป็นกรณี H5 ที่รองรับ ลิงก์อ้างอิงที่สองเป็นคู่มือ APP ซึ่ง OpenSDK, sendReq และ onResp เป็นอีกวิธีเชื่อมต่อหนึ่ง
ร้านค้าที่เชื่อมตรงต้องมีคุณสมบัติตามเกณฑ์ สิทธิ์ H5 การผูกหมายเลขร้านค้ากับ APPID และโดเมน H5 ที่ตั้งค่าไว้ ตรวจเงื่อนไขล่าสุดจากเอกสารทางการ หากใช้ 稳付pay ให้แจ้งโดเมน ธุรกิจ และสภาพแวดล้อมที่เปิดเว็บ เพื่อให้เทคนิคตรวจว่าช่องทางที่จัดสรรรองรับ H5 หรือไม่ การเผยแพร่บทความไม่ได้เปิด H5 ให้ร้านค้าทุกราย
อย่าเลือกโปรโตคอลจากชื่อเบราว์เซอร์หรือคิดว่าทุกช่องทาง WeChat เนทีฟมี H5 เหมือนกัน ต้องยืนยันสภาพแวดล้อม สิทธิ์ และช่องทางก่อนพัฒนา
2. ขั้นตอนเชื่อมต่อ 稳付pay ตั้งแต่เปิดช่องทางถึงใช้งานจริง
ขั้นที่ 1 ติดต่อ @tonyyyds แจ้งโดเมน ประเภทธุรกิจ เบราว์เซอร์หรือแอป ขั้นตอนเติมเงินหรือสมัครสมาชิก ปริมาณคำสั่ง และความต้องการรับชำระบัญชี USDT ทีมเทคนิคยืนยัน H5 ช่องทาง ค่าธรรมเนียม เงื่อนไข และวิธีทดสอบ ชื่อช่องทางไม่ได้แปลว่าเปิดสิทธิ์แล้ว
ขั้นที่ 2 รับ gateway จริง mchId, wayCode ที่อนุญาต และกุญแจฝั่งเซิร์ฟเวอร์ เตรียม notifyUrl ที่เข้าถึงได้จากภายนอกและตารางคำสั่ง เก็บกุญแจในระบบหลังบ้าน ตัวอย่างรหัสรวมคือ 90001 สำหรับ WeChat และ 80001 สำหรับ Alipay ซึ่งต้องได้รับสิทธิ์ก่อน หรืออาจได้รับรหัสช่องทางเฉพาะ
ขั้นที่ 3 บันทึก outTradeNo ไม่ซ้ำและราคาที่เชื่อถือได้ แล้วส่ง JSON จากระบบหลังบ้านไปยัง POST /api/pay/collect/create โดย amount เป็นจำนวนเต็มหน่วยเฟิน CNY ค่า 1000 เท่ากับ 10 หยวน reqTime ต้องเป็นเวลา Unix ปัจจุบันหน่วยมิลลิวินาทีแบบจำนวนเต็ม และสร้าง sign ตามกฎ MD5 ในคู่มือ ตัวอย่างด้านล่างเป็นฟิลด์ของวิธีชำระเงินนี้ ต้องแทนค่าตัวอย่างและลงนามบนเซิร์ฟเวอร์
{
"mchId": "YOUR_MERCHANT_ID",
"wayCode": "90001",
"outTradeNo": "YOUR_UNIQUE_ORDER_NO",
"amount": 1000,
"currencyCode": "CNY",
"notifyUrl": "https://merchant.example.com/pay/notify",
"subject": "WENFUPAY_H5_DEMO",
"reqTime": "CURRENT_UNIX_MILLISECONDS",
"sign": "GENERATE_MD5_ON_SERVER"
}ขั้นที่ 4 เก็บหมายเลขคำสั่งแพลตฟอร์ม และใช้ payUrl ที่ถูกต้องตามแนวทางที่ตกลง ห้ามสร้าง URL ชำระเงินเอง code=0 หมายถึงรับคำขอ ไม่ใช่รับเงิน จึงยังเพิ่มยอดไม่ได้ การเปิดแอปโดยตรงขึ้นกับผลทดสอบช่องทางและเบราว์เซอร์
ขั้นที่ 5 รับ JSON callback รูปแบบกลางของ 稳付pay ตรวจลายเซ็น ร้านค้า คำสั่ง จำนวนเงิน และสกุลเงิน แล้วบันทึกครั้งเดียว หลังเก็บข้อมูลถาวรให้ตอบ HTTP 200 และข้อความล้วน OK หาก callback ไม่มาหรือไม่ทราบผลสร้างคำสั่ง ให้ระบบหลังบ้านตรวจคำสั่งเดิมด้วย GET /api/pay/collect/query โดยยืนยันหน่วยเงินของผลสอบถามกับเทคนิค
ขั้นที่ 6 ทดสอบชำระ ยกเลิก หมดเวลา callback ซ้ำ และเพิ่มยอดตามสภาพแวดล้อมที่ทีมจัดให้ ตรวจคำสั่งจริงชุดแรกก่อนเพิ่มการใช้งาน ลิงก์ด้านล่างใช้ติดต่อและอ่านคู่มือครบถ้วน
ติดต่อ 稳付pay · ขั้นตอนเชื่อมต่อ · สร้างและสอบถามคำสั่ง · กฎลายเซ็น · Callback การชำระเงิน
3. จุดเด่นของช่องทางและบริการ 稳付pay
ทางเลือกรับเงินหลายแบบ: ปัจจุบันมีรับชำระด้วยรหัสส่วนบุคคล WeChat, WeChat เนทีฟ และ Alipay เนทีฟ พร้อมการเชื่อมต่อแบบรวม ช่วยลดงานเชื่อมแต่ละช่องทางแยกกัน แต่ H5 ขึ้นกับช่องทางที่เปิดไว้ ผลการทำงานปัจจุบันมีเสถียรภาพ อย่างไรก็ตามขึ้นกับคำสั่ง สภาพแวดล้อมผู้ใช้ และสถานะช่องทาง จึงไม่รับประกันเปอร์เซ็นต์สำเร็จตายตัว
คำสั่งและ callback รูปแบบเดียว: ใช้จุดชำระเงินที่ส่งกลับ พร้อมขั้นตอนสร้างคำสั่ง สอบถาม และ JSON callback เพื่อเชื่อมเติมเงิน สมาชิก ส่งรหัสสินค้า หรือคำสั่ง TG bot กับระบบตนเอง แพลตฟอร์มแจ้งสถานะเงิน ส่วนร้านค้าอัปเดตยอดและสิทธิ์จากผลที่ตรวจแล้ว การรับ callback ไม่ได้หมายถึงทุกงานธุรกิจเสร็จอัตโนมัติ
ชำระบัญชี USDT แบบเรียลไทม์ T0: หลังยืนยันลูกค้าชำระแล้ว สามารถชำระบัญชี USDT ให้ร้านค้าตามข้อตกลง ต้องยืนยันยอดที่เข้าเกณฑ์ ค่าธรรมเนียม อัตราแปลง เครือข่าย และที่อยู่ก่อน การดำเนินการและเงินถึงบนเชนยังมีเงื่อนไขและการยืนยัน ไม่ใช่ฟรี ไม่ต้องยืนยัน หรือถึงทันทีทุกคำสั่ง
ทีมเทคนิคช่วยเชื่อมต่อ: ปรึกษาการตั้งค่าร้านค้า ช่องทาง ลายเซ็น การสอบถาม และปัญหา callback ได้ การรับ WeChat หรือ Alipay แล้วชำระบัญชี USDT ต่างจากการเฝ้าดู USDT ที่ที่อยู่ของร้านค้าเอง แบบหลังลูกค้าส่งตรงเข้ากระเป๋าร้านค้า และ 稳付pay ตรวจการยืนยันแล้วส่ง callback ต้องอธิบายเส้นทางเงินแยกกัน
4. แยกพารามิเตอร์ H5 ทางการกับลิงก์ 稳付pay
ระบบหลังบ้านสร้างคำสั่งที่ผูกกับผู้ใช้ที่เข้าสู่ระบบ สินค้าหรือแพ็กเกจเติมเงิน จำนวนเงิน และสกุลเงิน ราคามาจากเซิร์ฟเวอร์ ไม่เชื่อราคาที่หน้าเว็บส่งมา หากใช้ API v3 โดยตรง เรียก POST /v3/pay/transactions/h5 ด้วย out_trade_no ไม่ซ้ำ และฟิลด์ เช่น notify_url, amount, scene_info โดย amount.total เป็นจำนวนเต็มหน่วยเฟิน CNY เช่น 10 หยวนใช้ 1000 การลงนามและกุญแจส่วนตัวอยู่บนเซิร์ฟเวอร์ ช่องทาง 稳付pay ต้องใช้ฟิลด์ หน่วยเงิน และวิธีลงนามตามเอกสารจริง ไม่คัดพารามิเตอร์ทางการมาใช้ตรง ๆ
เปลี่ยนจากหน้าเว็บบนโดเมน H5 ที่ตั้งค่าแล้วไปยัง h5_url หากกำหนดหน้ากลับ ให้เพิ่ม redirect_url เป็นพารามิเตอร์โดยเก็บพารามิเตอร์ชำระเงินเดิมทั้งหมด และเข้ารหัส URL หน้ากลับอย่างถูกต้องหนึ่งครั้ง โดเมนกลับต้องตั้งค่าเป็นโดเมน H5 เช่นกัน ระวังเข้ารหัสซ้ำเมื่อใช้ไลบรารีสร้าง URL โดย redirect_url คือหน้าที่เบราว์เซอร์กลับ ส่วน notify_url รับการแจ้งเตือนระหว่างเซิร์ฟเวอร์ จึงแทนกันไม่ได้
คู่มือ H5 ทางการระบุว่า h5_url ใช้ได้ห้านาที ต่างจากกำหนดชำระเงินของคำสั่ง เมื่อลิงก์หมดอายุให้ตรวจสถานะก่อน หากยังจ่ายได้จึงขอลิงก์ใหม่ด้วยพารามิเตอร์เดิมตามคู่มือ ถ้าเลยกำหนดธุรกิจ ให้สอบถามแล้วปิดหรือสร้างคำสั่งใหม่ตามกฎ API ตัวนับเวลาหน้าเว็บไม่ใช่หลักฐานว่าจ่ายไม่สำเร็จ
5. ยืนยันเงินก่อน callback และเพิ่มยอด
ผู้ใช้ที่สำเร็จและผู้ใช้ที่ยกเลิกอาจกลับหน้าเดียวกัน การถึง redirect_url ข้อความสำเร็จ หรือภาพสลิปเพียงอย่างเดียวไม่เพียงพอให้เพิ่มเงิน ควรมีปุ่มตรวจผลให้ระบบหลังบ้านสอบถามคำสั่งที่ผู้ใช้มีสิทธิ์ดู แล้วแสดงผลยืนยันหรือรอตรวจ ห้ามเพิ่มเงินจากจำนวนเงินหรือค่า success ใน URL หน้ากลับ
API v3 ทางการต้องตรวจการแจ้งเตือนและถอดรหัสตามข้อกำหนด ส่วนร้านค้า 稳付pay ใช้เอกสาร callback จริง ทั้งสองแบบต้องเทียบผู้รับ หมายเลขคำสั่ง หมายเลขธุรกรรม จำนวนเงิน และสกุลเงิน ให้ผลสอบถามและ callback เข้าการจัดการสถานะเดียวกัน และไม่ให้ผลยังไม่จ่ายที่มาช้าเขียนทับสถานะสำเร็จ
การเติมเงินต้องมีรายการเพิ่มยอดไม่ซ้ำต่อคำสั่ง และอัปเดตคำสั่งพร้อมบัญชียอดคงเหลือในธุรกรรมฐานข้อมูลเดียวกัน callback ซ้ำ การตรวจซ้ำ หรือรีเฟรชต้องไม่เพิ่มอีก การเปิดสมาชิกและส่งสินค้าก็ต้องกันซ้ำ หากรับเงินแล้วแต่ให้สิทธิ์ล้มเหลว ให้เก็บงานลองใหม่แทนการขอจ่ายซ้ำ ตอบรับตาม API หลังบันทึกการแจ้งเตือนอย่างถาวรแล้ว
6. ตรวจรับกรณีเปิดไม่ขึ้น หน้ากลับว่าง และยอดเข้าช้า
หาก WeChat ไม่เปิด ให้เก็บหมายเลขคำสั่ง เวลา ระบบปฏิบัติการ เบราว์เซอร์ สภาพแวดล้อมจริง ข้อผิดพลาด และรหัสคำขอที่ปกปิดข้อมูล ตรวจสิทธิ์ H5 โดเมน อายุลิงก์ เส้นทางเปลี่ยนหน้า และการอนุญาตเปิด WeChat อย่าปลอมแหล่งที่มาหรือข้ามตรวจโดเมน และไม่รับประกันทุกเบราว์เซอร์เปิดอัตโนมัติ
หน้ากลับว่างให้ตรวจการเข้ารหัส redirect_url โดเมน เส้นทาง และการกู้สถานะเข้าสู่ระบบ หากยืนยันเงินแต่ยอดไม่เพิ่ม ให้ตรวจธุรกรรม การตรวจ callback สถานะคำสั่ง และบัญชีเพิ่มยอด ใช้การสอบถามเสริมเมื่อ callback ไม่มา แต่ไม่สร้างคำสั่งแทนรายการที่จ่ายแล้วโดยไม่ตรวจ ปกปิดบันทึกและไม่เผยลิงก์ชำระเงินหรือกุญแจในหน้าหรือคำร้องสาธารณะ
ทดสอบสำเร็จ ยกเลิก หมดอายุ ปิดหน้า callback ช้าหรือซ้ำ การสอบถามพร้อม callback และกู้คืนหลังเขียนยอดล้มเหลว ตรวจว่าคำสั่งหนึ่งเพิ่มครั้งเดียวและติดตามถึงบัญชีได้ 稳付pay ช่วยตรวจแนวทางเชื่อมต่อ ส่วนค่าธรรมเนียม ช่องทาง และเงื่อนไขชำระบัญชี USDT ตกลงแยก การเปิดหน้าชำระเงินไม่ได้แปลว่าจ่ายหรือชำระบัญชีเสร็จแล้ว
คำถามที่พบบ่อย
H5 ไม่ต้องมีคุณสมบัติร้านค้าหรือตั้งโดเมนใช่ไหม?
ไม่ใช่ H5 ทางการต้องมีคุณสมบัติ สิทธิ์ผลิตภัณฑ์ และโดเมนที่ตั้งค่าไว้ หากใช้ 稳付pay ทีมเทคนิคตรวจธุรกิจ โดเมน สภาพแวดล้อม และพารามิเตอร์ ระบบรวมช่องทางไม่ได้ยกเว้นการตรวจหรือข้ามกฎ WeChat
ผู้ใช้กดเสร็จแต่ callback ยังไม่มา เพิ่มยอดเลยได้ไหม?
อย่าอาศัยการกดปุ่มอย่างเดียว ระบบหลังบ้านต้องยืนยันผล ผู้รับ จำนวนเงิน และสกุลเงินก่อน แล้วใช้ขั้นตอนเพิ่มยอดที่กันซ้ำ หากยังยืนยันไม่ได้ให้แสดงรอตรวจและใช้หมายเลขคำสั่งสอบทานเพื่อหลีกเลี่ยงจ่ายซ้ำ
เอกสารอ้างอิง
- WeChat Pay: การเปิดชำระเงิน H5
- WeChat Pay: คู่มือ APP ซึ่งเป็นการเชื่อมต่อคนละแบบ
- WeChat Pay: ภาพรวมการชำระเงิน H5
- WeChat Pay: การเตรียมเชื่อมต่อ H5
- WeChat Pay: คู่มือพัฒนา H5
- WeChat Pay: พารามิเตอร์สร้างคำสั่งชำระเงิน H5
- สร้างและสอบถามรับชำระแทน: ช่องข้อมูล จำนวนเงิน และสถานะคำสั่งซื้อ
- กฎลายเซ็นคำขอ: เรียงพารามิเตอร์และคำนวณ MD5
- ช่องทางชำระเงินของ稳付pay: QR ส่วนบุคคล WeChat, WeChat แบบเนทีฟ, Alipay แบบเนทีฟ และชำระบัญชี USDT เรียลไทม์ T0