wechatpay postman script

สคริปต์บุรุษไปรษณีย์ APIv3 การชำระเงิน WeChat

WeChat Payment APIv3 บุรุษไปรษณีย์ร้องขอสคริปต์คำขอล่วงหน้า (สคริปต์คำขอล่วงหน้า)

เพื่อช่วยให้นักพัฒนาผู้ค้าเริ่มต้นได้อย่างรวดเร็ว เราได้ปรับใช้สคริปต์กับเวิร์กเบนช์ระบบคลาวด์ของบุรุษไปรษณีย์ WeChat Pay Public Workspace คุณไม่จำเป็นต้องนำเข้าสคริปต์ด้วยตนเอง คุณเพียงแค่ต้องแยกคอลเลกชัน "WeChat Payment APIv3" ไปยังโต๊ะทำงานของคุณ และคุณสามารถสร้างและส่งคำขอ WeChat Payment APIv3 บนบุรุษไปรษณีย์ได้อย่างง่ายดาย

เงื่อนไขเบื้องต้น

• Postman แพลตฟอร์มที่มีชื่อเสียงในอุตสาหกรรมสำหรับการสร้างและใช้งาน API ขอแนะนำให้ลงทะเบียนบัญชีเพื่อใช้ฟังก์ชันต่างๆ
• มาเป็นผู้ค้าชำระเงิน WeChat
• รหัสส่วนตัวของ Merchant API: เมื่อผู้ค้าสมัครใบรับรอง API ของผู้ค้า รหัสส่วนตัวของผู้ค้าจะถูกสร้างขึ้นและบันทึกไว้ในไฟล์ apiclient_key.pem ในโฟลเดอร์ใบรับรองในเครื่อง

เริ่มต้นอย่างรวดเร็ว

ขั้นตอนที่ 1: สคริปต์นำเข้า Fork

คลิกปุ่มเพื่อเข้าสู่วิซาร์ดดังที่แสดงด้านล่าง

คลิก Fork Collection เพื่อไปยังขั้นตอนต่อไป กรอกป้ายกำกับ Fork Label และเลือก Workspace ภายใต้สถานการณ์ปกติ การนำเข้า My Workspace ของโต๊ะทำงานส่วนตัวก็เพียงพอแล้ว

คลิก Fork Collection เพื่อดำเนินการนำเข้าให้เสร็จสิ้น คุณสามารถดู "WeChat Payment APIv3" ได้ในพื้นที่ทำงานที่คุณกำหนด

คุณยังสามารถนำเข้าสคริปต์ในเครื่องได้

ขั้นตอนที่ 2: กำหนดค่าสภาพแวดล้อม

สภาพแวดล้อมคือชุดของตัวแปร สคริปต์อ่านตัวแปรจากสภาพแวดล้อมและใช้เพื่อคำนวณลายเซ็นของคำขอ

คุณสามารถแยกสภาพแวดล้อมที่ว่างเปล่าจากเทมเพลตพารามิเตอร์ผู้ขายที่ "WeChat Payment APIv3" มอบให้ไปยังโต๊ะทำงานของคุณเองได้

ถัดไป ค้นหาสภาพแวดล้อมที่สร้างขึ้นใหม่ใน สภาพแวดล้อม บนเวิร์กเบนช์ของคุณ และคลิก Add a new varialbe เพื่อเพิ่มตัวแปรใหม่:

• mchid : ต้องระบุ หมายเลขร้านค้า
• merchant_serial_no : จำเป็น, หมายเลขซีเรียลใบรับรอง API ของผู้ค้า
• apiclient_key.pem : จำเป็นต้องมีคีย์ส่วนตัวของ Merchant API ในรูปแบบ PEM

คำเตือนเพื่อ ความปลอดภัย โปรดอ่านข้อควรระวังด้านความปลอดภัยอย่างละเอียด

ชุดการกำหนดค่าทั่วไปแสดงอยู่ด้านล่าง

ขั้นตอนที่ 3: ส่งคำขอ

หมายเหตุ: เราขอแนะนำให้ใช้แอปบุรุษไปรษณีย์บนเดสก์ท็อปเพื่อส่งคำขอ ซึ่งเร็วกว่าและมีประสบการณ์ที่ดีกว่า!

ตอนนี้กลับไปที่โต๊ะทำงาน เข้าสู่คอลเลกชัน "WeChat Payment APIv3" และเลือกคำขอที่คุณต้องการส่ง

จากนั้นกรอกพารามิเตอร์คำขอและแก้ไขพารามิเตอร์ในเนื้อหาตามความคิดเห็น

สุดท้าย เลือกสภาพแวดล้อมที่คุณกำหนดค่าไว้ก่อนหน้านี้ แล้วคลิกปุ่ม Send ทางด้านขวาของแถบที่อยู่เพื่อส่งคำขอ

หลักการปฏิบัติ

Pre-Request Script เป็นสคริปต์ Javascript บุรุษไปรษณีย์รันสคริปต์นี้ก่อนที่จะส่งคำขอ สคริปต์ทำสิ่งต่อไปนี้:

1. โหลดไลบรารี่ที่ขึ้นต่อกัน
2. อ่านตัวแปรพารามิเตอร์ผู้ค้าในสภาพแวดล้อม
3. สร้างสตริงลายเซ็นตามวิธีการ, URL, พารามิเตอร์, เนื้อความ และข้อมูลอื่นๆ ที่ร้องขอ และคำนวณลายเซ็นคำขอ
4. ตั้ง Authorization หัวคำขอ

หมายเหตุ สำหรับข้อมูลเพิ่มเติมเกี่ยวกับการเขียนสคริปต์บุรุษไปรษณีย์ ดูการเขียนสคริปต์ในบุรุษไปรษณีย์

ตัวแปรพารามิเตอร์

ชื่อตัวแปร	มันจำเป็นไหม?	อธิบาย	หมายเหตุ
เอ็มคิด	ใช่	หมายเลขร้านค้า
Merchant_serial_no	ใช่	หมายเลขซีเรียลใบรับรองของใบรับรอง API ของผู้ค้า
apiclient_key.pem	ใช่	รหัสส่วนตัวของ Merchant API ในรูปแบบ PEM
เปิดรหัส	เลขที่	OpenID ของผู้ใช้ {{openid}} ในคำขอทดสอบ
สมัคร	เลขที่	AppID ของบัญชีสาธารณะหรือมินิโปรแกรม
แชงมี	เลขที่	ใช้ลายเซ็นลับทางการค้าเมื่อค่าเป็น true	ค่าเริ่มต้นว่างเปล่า ซึ่งหมายถึงการใช้ลายเซ็น RSA
pubkey.pem	จำเป็นเมื่อลงนามด้วยความลับของรัฐ	รหัสสาธารณะ Merchant API ในรูปแบบ PEM	หากคีย์ส่วนตัว PEM มีคีย์สาธารณะ ก็ไม่จำเป็นต้องกรอกตัวแปรนี้
เซิร์ฟเวอร์_url	เลขที่	ที่อยู่เซิร์ฟเวอร์	การตั้งค่าเริ่มต้นคือ https://api.mch.weixin.qq.com

ห้องสมุดที่ต้องพึ่งพา

สคริปต์ใช้โดยตรง:

• forge.min.js, PKI, RSA และ ASN.1 สำหรับการปลอมแปลง
• sm2.js ซึ่งเป็นลายเซ็น SM2 ของ TencentSM-javascript ไลบรารีลับระดับชาติของ Tencent

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

ข้อควรระวังด้านความปลอดภัย

คีย์ส่วนตัวของ Merchant API เป็นข้อมูลที่ละเอียดอ่อนมาก เมื่อใช้รหัสนี้ คุณควรคำนึงถึงประเด็นต่อไปนี้:

• ตั้งค่าการเปิดเผยพื้นที่ทำงานที่กำหนดค่าด้วยคีย์ส่วนตัวเป็น Personal หรือ Private และอย่า ตั้งค่าเป็น Public
• ประเภทของตัวแปร ของคีย์ส่วนตัวถูกตั้งค่าเป็น secret ค่าตัวแปรจะแสดงบนหน้าจอในรูปแบบของมาสก์
• ค่าตัวแปร ของคีย์ส่วนตัวถูกตั้งค่าเป็น Current Value Current Value จะถูกบันทึกในเซสชันภายในเครื่องเท่านั้น และจะไม่ถูกส่งไปยังเซิร์ฟเวอร์บุรุษไปรษณีย์
• หากคุณใช้สคริปต์บุรุษไปรษณีย์จากบุคคลอื่น โปรดตรวจสอบไลบรารี ตัวแปร และสคริปต์ที่ขึ้นต่อกัน เพื่อให้แน่ใจว่าสคริปต์เหล่านั้นไม่ได้รับการแก้ไขเพื่อหลีกเลี่ยงการฝังโค้ดที่ไม่ปลอดภัย

หมายเหตุสำหรับข้อมูล เกี่ยวกับกลไกความปลอดภัยของบุรุษไปรษณีย์ โปรดดูที่ ความปลอดภัยของบุรุษไปรษณีย์

วิธีการเริ่มคำขอความลับของรัฐ

ใช้เทมเพลตพารามิเตอร์ National Secret-Merchant และตั้งค่าในตัวแปรสภาพแวดล้อม:

• shangmi : ค่าเป็น true
• mchid : ต้องระบุ หมายเลขร้านค้า
• merchant_serial_no : จำเป็น, หมายเลขซีเรียลใบรับรอง API ของผู้ค้า
• apiclient_key.pem : จำเป็นต้องมีคีย์ส่วนตัวของ Merchant API ในรูปแบบ PEM
• pubkey.pem : จำเป็น รหัสสาธารณะความลับระดับชาติของ Merchant API ในรูปแบบ PEM

ด้วยวิธีนี้ สคริปต์จะใช้ SM2 ที่เป็นความลับของชาติเพื่อคำนวณลายเซ็นและส่งคำขอที่เป็นความลับของชาติ

สคริปต์นำเข้าท้องถิ่น

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

การนำเข้า Fork Collection จำเป็นต้องลงทะเบียนบัญชีบุรุษไปรษณีย์ หากคุณไม่ต้องการลงทะเบียน คุณสามารถนำเข้าสคริปต์ในเครื่องได้

ขั้นแรก เปิดคอลเลกชัน WeChatPay APIv3 ขยายตัวเลือกแล้วคลิกส่งออก:

ดาวน์โหลดและบันทึกไฟล์ wechatpay-apiv3.postman_collection.json ในเครื่อง จากนั้น มีสองวิธีในการนำเข้าไฟล์ JSON ภายในเครื่อง:

• ปุ่ม Import ที่มุมซ้ายบนของอินเทอร์เฟซบุรุษไปรษณีย์
• File เมนู > Import จะเริ่มการนำเข้า

เลือก wechatpay-apiv3.postman_collection.json ในพื้นที่ แล้วคลิกยืนยันเพื่อดำเนินการนำเข้าให้เสร็จสิ้น

คุณจะพบว่ามีการเพิ่มคำขอชุดใหม่ชื่อ "WeChatPay APIv3" ไปยังคอลเลกชันบนเวิร์กเบนช์ หลังจากกำหนดค่าสภาพแวดล้อมแล้ว คุณสามารถส่งคำขอได้

ซิงค์การเปลี่ยนแปลงต้นน้ำ

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

ในขณะนี้ คุณสามารถใช้ pull changes เพื่อดึงการเปลี่ยนแปลงอัปสตรีมได้

pull changes ของบุรุษไปรษณีย์อาจใช้เวลาสักครู่จึงจะเสร็จสมบูรณ์ หากคุณพบปัญหา การฟอร์กใหม่ก็เป็นความคิดที่ดีเช่นกัน

คำถามที่พบบ่อย

เมื่อส่งคำขอ พบข้อความแสดงข้อผิดพลาด "ข้อผิดพลาด: มีไบต์น้อยเกินไปที่จะแยกวิเคราะห์ DER" หรือ "มีไบต์น้อยเกินไปที่จะอ่านค่า ASN.1"

มักเกิดจากการกรอกตัวแปร merchantPrivateKey ที่กำหนดค่าในสภาพแวดล้อมไม่ถูกต้อง รหัสส่วนตัวที่ได้รับจากสคริปต์คือสตริงที่ขึ้นต้นด้วย -----BEGIN PRIVATEKEY----- และลงท้ายด้วย -----END PRIVATE KEY-----

เหตุใดคำขอส่งของฉันจึงช้ามาก?

หากคุณใช้บุรุษไปรษณีย์เวอร์ชันเว็บ โปรดใช้แอปบุรุษไปรษณีย์บนเดสก์ท็อป เนื่องจากข้อจำกัดของการแบ่งปันทรัพยากรข้ามต้นทาง (CORS) ในเบราว์เซอร์ คำขอที่ส่งโดยเวอร์ชันเว็บจะถูกส่งต่อโดยบุรุษไปรษณีย์ในเบื้องหลัง

หรือใช้ตัวแทนเดสก์ท็อปของบุรุษไปรษณีย์ สำหรับข้อมูลเพิ่มเติม โปรดดูบล็อกที่เกี่ยวข้องกับบุรุษไปรษณีย์

ติดต่อเรา

หากคุณมีคำถามใด ๆ โปรดไปที่ชุมชนนักพัฒนาของเราเพื่อรับข้อเสนอแนะ

นอกจากนี้เรายังยินดีรับทุกปัญหาและคำขอรวม :-)