wechatpay postman script
1.0.0
طلب WeChat Payment APIv3 Postman البرنامج النصي للطلب المسبق (البرنامج النصي للطلب المسبق).
من أجل مساعدة المطورين التجاريين على البدء سريعًا، نقوم بنشر البرنامج النصي على مساحة عمل Postman السحابية WeChat Pay Public Workspace. لا تحتاج إلى استيراد البرنامج النصي يدويًا، ما عليك سوى تفرع مجموعة "WeChat Payment APIv3" إلى طاولة العمل الخاصة بك، ويمكنك بسهولة إنشاء وإرسال طلبات WeChat Payment APIv3 على Postman.
انقر فوق الزر للدخول إلى المعالج، كما هو موضح أدناه.
انقر فوق Fork Collection للمتابعة إلى الخطوة التالية، واملأ التسمية Fork Label وحدد Workspace العمل الوجهة Workspace . في الظروف العادية، يكفي استيراد طاولة العمل الشخصية My Workspace.
انقر فوق Fork Collection لإكمال عملية الاستيراد. يمكنك رؤية "WeChat Payment APIv3" في مساحة العمل المخصصة لك.
يمكنك أيضًا استيراد البرامج النصية محليًا.
البيئة عبارة عن مجموعة من المتغيرات يقرأ البرنامج النصي المتغيرات من البيئة ويستخدمها لحساب توقيع الطلب.
يمكنك تفرع بيئة فارغة من قالب معلمة التاجر المقدم بواسطة "WeChat Payment APIv3" إلى منصة العمل الخاصة بك.
بعد ذلك، ابحث عن البيئة التي تم إنشاؤها حديثًا في البيئات على طاولة العمل الخاصة بك وانقر فوق Add a new varialbe لإضافة متغير جديد:
mchid : مطلوب رقم التاجر.merchant_serial_no : مطلوب، الرقم التسلسلي لشهادة API الخاصة بالتاجر.apiclient_key.pem : مطلوب مفتاح خاص لواجهة برمجة تطبيقات التاجر بتنسيق PEM.تحذيرللسلامة ، يرجى قراءة احتياطات السلامة بعناية.
يتم عرض مجموعة مشتركة من التكوينات أدناه.
ملاحظة: نوصي باستخدام تطبيق Postman لسطح المكتب لإرسال الطلبات، وهو أسرع ويتمتع بتجربة أفضل!
عد الآن إلى طاولة العمل، وأدخل مجموعة "WeChat Payment APIv3"، وحدد الطلب الذي تريد إرساله.
ثم قم بملء معلمات الطلب وتعديل المعلمات في النص وفقًا للتعليقات.
أخيرًا، حدد البيئة التي قمت بتكوينها مسبقًا وانقر فوق الزر Send الموجود على الجانب الأيمن من شريط العناوين لإرسال الطلب.
Pre-Request Script هو برنامج نصي جافا سكريبت. يقوم ساعي البريد بتنفيذ هذا البرنامج النصي قبل إرسال الطلب. يقوم البرنامج النصي بما يلي:
Authorization رأس الطلبملاحظةلمزيد من المعلومات حول البرمجة النصية لـ Postman، راجع البرمجة النصية في Postman.
| اسم متغير | هل هو مطلوب؟ | يصف | ملاحظة |
|---|---|---|---|
| mchid | نعم | رقم التاجر | |
| Merchant_serial_no | نعم | الرقم التسلسلي لشهادة واجهة برمجة تطبيقات التاجر | |
| apiclient_key.pem | نعم | المفتاح الخاص لـ Merchant API بتنسيق PEM | |
| معرف مفتوح | لا | معرف OpenID الخاص بالمستخدم، {{openid}} في طلب الاختبار | |
| appid | لا | معرف التطبيق للحساب العام أو البرنامج المصغر | |
| com.shangmi | لا | استخدم توقيع السر التجاري عندما تكون القيمة true | القيمة الافتراضية فارغة، مما يعني استخدام توقيع RSA |
| pubkey.pem | مطلوب عند التوقيع بأسرار الدولة | المفتاح العام لـ Merchant API بتنسيق PEM | إذا كان المفتاح الخاص PEM يحتوي على المفتاح العام، فلن يلزم ملء هذا المتغير |
| server_url | لا | عنوان الخادم | الإعداد الافتراضي هو https://api.mch.weixin.qq.com |
يستخدم البرنامج النصي مباشرة:
لتجنب تنزيل المكتبات التابعة عند كل طلب، يتم تخزين المكتبتين في متغيرات المجموعة كرمز مصدر. وهذا يقلل بشكل كبير من الوقت المستغرق عند إرسال الطلبات باستخدام إصدار الويب من Postman.
تعد المفاتيح الخاصة لـ Merchant API معلومات حساسة للغاية. عند استخدام هذا الكود، عليك أن تضع النقاط التالية في الاعتبار:
Personal أو Private ، ولا تقم بتعيينها إلى Public .secret . يتم عرض القيم المتغيرة على الشاشة على شكل قناع.Current Value . يتم حفظ Current Value فقط في الجلسة المحلية ولن يتم إرسالها إلى خادم Postman.ملاحظةللحصول على معلومات حول آلية أمان Postman، يرجى الرجوع إلى Postman Security.
استخدم قالب معلمة National Secret-Merchant وقم بتعيينه في متغير البيئة:
shangmi : القيمة true .mchid : مطلوب رقم التاجر.merchant_serial_no : مطلوب، الرقم التسلسلي لشهادة API الخاصة بالتاجر.apiclient_key.pem : مطلوب مفتاح خاص لواجهة برمجة تطبيقات التاجر بتنسيق PEM.pubkey.pem : مطلوب، المفتاح العام السري الوطني لواجهة برمجة التطبيقات التجارية بتنسيق PEM.بهذه الطريقة، سيستخدم البرنامج النصي السر الوطني SM2 لحساب التوقيع وإرسال طلب السر الوطني.
ملاحظة: لا يُنصح باستيراد البرامج النصية محليًا، فهذا أمر مرهق وعرضة للخطأ ولا يمكن مزامنة التغييرات الأولية.
يتطلب استيراد Fork Collection تسجيل حساب Postman. إذا كنت لا ترغب في التسجيل، يمكنك استيراد البرنامج النصي محليا.
أولاً، افتح مجموعة WeChatPay APIv3، وقم بتوسيع الخيارات وانقر فوق "تصدير":
قم بتنزيل وحفظ ملف wechatpay-apiv3.postman_collection.json محليًا. ثم هناك طريقتان لاستيراد ملف JSON محليًا:
Import في الزاوية اليسرى العليا من واجهة ساعي البريدFile القائمة > Import يبدأ عملية الاستيراد حدد wechatpay-apiv3.postman_collection.json المحلي وانقر فوق تأكيد لإكمال الاستيراد.
ستجد أنه تمت إضافة مجموعة جديدة من الطلبات باسم "WeChatPay APIv3" إلى المجموعات الموجودة على طاولة العمل. بعد تكوين البيئة، يمكنك إرسال الطلب.
سنقوم تدريجيًا بإضافة واجهات جديدة وتحديث الواجهات الموجودة، لكن فرع المجموعة الذي تفرعته إلى طاولة العمل الخاصة بك لن يقوم تلقائيًا بمزامنة التغييرات الأولية. يوصى watch مساحة العمل العامة الخاصة بنا حتى تتلقى إشعارات من ساعي البريد عند إجراء تغييرات على المنبع.
في هذا الوقت، يمكنك استخدام pull changes لسحب التغييرات الأولية.
قد تستغرق pull changes Postman بعض الوقت حتى تكتمل. إذا واجهت مشاكل، فإن إعادة التفرع هي أيضًا فكرة جيدة.
يحدث هذا عادةً بسبب ملء متغير merchantPrivateKey بشكل غير صحيح والذي تم تكوينه في البيئة. المفتاح الخاص الذي يتلقاه البرنامج النصي هو سلسلة تبدأ بـ -----BEGIN PRIVATEKEY----- وتنتهي بـ -----END PRIVATE KEY----- .
إذا كنت تستخدم إصدار الويب من Postman، فيرجى استخدام تطبيق Postman لسطح المكتب. نظرًا للقيود المفروضة على مشاركة الموارد عبر الأصل (CORS) في المتصفحات، تتم إعادة توجيه الطلبات المرسلة بواسطة إصدار الويب بواسطة Postman في الخلفية.
أو استخدم وكيل سطح المكتب Postman لمزيد من المعلومات، يرجى الرجوع إلى المدونات ذات الصلة بـ Postman.
إذا كانت لديك أي أسئلة، يرجى زيارة مجتمع المطورين لدينا للحصول على تعليقات.
نرحب أيضًا بجميع أنواع المشكلات وطلبات الدمج :-)
