wepay

نحن ندفع

مكون Wechat Pay خفيف الوزن

• استيراد الحزمة:

   < dependency >
       < groupId >me.hao0</ groupId >
       < artifactId >wepay-core</ artifactId >
       < version >1.3.2</ version >
   </ dependency >

• الحزم التابعة، انتبه إلى ما إذا كنت بحاجة إلى الاستبعاد عند تقديم المشروع:

   < dependency >
       < groupId >me.hao0</ groupId >
       < artifactId >common</ artifactId >
       < version >1.1.2</ version >
   </ dependency >
   

• الاستخدام الأساسي:

   Wepay wepay = WepayBuilder
                   . newBuilder ( appId , appKey , mchId )
                   . config1 (...)	// 其他可选配置
                   ...
                   . build ();
   
   wepay . module (). api ();

• المكونات المنفذة:

  • دفع pay() ؛
  • استرداد refund() ؛
  • order() ؛
  • إخطار notify() ؛
  • bill() .

• وثائق API هنا .

• حول الاختبار :

  • تتضمن حالات الاختبار بعض الاختبارات الأساسية التي تتطلب بعض التكوين:

     // 在test/reources目录中配置dev.properties
     // 包括appId(APP ID), appKey(支付密钥), mchId(商户号)
     Properties props = new Properties ();
     InputStream in = Object . class . getResourceAsStream ( "/dev.properties" );
     props . load ( in );
     in . close ();
      
      // 配置证书，退款需要证书，不配置可测试除退款的接口 
     Path path = Paths . get ( "/path/to/your_cert.p12" );
     byte [] data = Files . readAllBytes ( path );
    
     wepay = WepayBuilder . newBuilder (
             props . getProperty ( "appId" ),
             props . getProperty ( "appKey" ),
             props . getProperty ( "mchId" ))
             . certPasswd ( props . getProperty ( "mchId" ))
             . certs ( data )
             . build ();

  • مشروع wepay-demo هو مشروع ويب قابل للتشغيل، وهو مناسب للاختبار. يمكنك اختباره وفقًا للخطوات التالية. انسخ app-example.properties في wepay-demo إلى app.properties وقم بتكوينه وفقًا لذلك:

     # 微信app id
     appId =
     # 微信支付key
     appKey =
     # 商户号
     mchId =
     # 支付通知url
     payNotifyUrl = $ { your_domain } / notifies / paid

  • ملاحظة : يجب تكوين ** payNotifyUrl ** كعنوان يمكن لخادم WeChat الاتصال به من الشبكة الخارجية للاختبار المحلي، يوصى باستخدام أداة ngrok لرسم خرائط الشبكة المحلية والخارجية.

  • انتقل إلى الدليل الجذر wepay-demo وقم بتشغيل الأمر التالي:

     mvn clean jetty:run -Dmaven.test.skip -Djetty.port={自定义端口号}

  • يمكن الوصول إلى الدفع الديناميكي برمز الاستجابة السريعة ( بعد أن يصبح الطلب طبيعيًا، ستظهر صورة رمز الاستجابة السريعة التي تم إنشاؤها بواسطة Liantu. بعد نجاح الدفع عن طريق المسح باستخدام WeChat، سيتم استلام Notifies الإشعارات المقابلة في الخلفية ):

     http://localhost:{port}/pays/qrpay ? orderNumber={自定义订单号}

  • يمكن الوصول إلى استرداد الأموال ( بعد الإرسال الناجح، سيتم إخطار رسالة على WeChat ):

     http://localhost:{port}/refunds/apply ? orderNumber={商户订单号}		` ` `
     

• الوثائق ذات الصلة:

  • مستند دفع WeChat.

• النسخة التاريخية:

  • 1.0.0:

    • يتم تنفيذ الوظائف الأساسية.

  • 1.1.0:

    • إضافة الاستعلام عن الفاتورة.

  • 1.1.1:

    • إصلاح معرف الدفع المسبق.

  • 1.1.2:

    • تم إصلاح مشكلة توقيع دفع JS/APP.

  • 1.2.2:

    • تمت إضافة حقول استعلام الاسترداد: حالة الاسترداد، مبلغ الاسترداد، طرف حساب الاسترداد.

  • 1.2.3:

    • الإصلاح NullOrEmpty.

  • 1.2.4:

    • بعد الترقية المشتركة إلى 1.1.2، يمكنك تكوين نوع التشفير لتحليل WeChat XML، الإعداد الافتراضي هو UTF-8 لمنع عدم الاتساق مع التشفير الافتراضي المحلي.

  • 1.2.5:

    • يتم تحديث نتيجة الدفع برمز QR إلى QrPayResponse، ويتم إضافة حقل prepay_id .

  • 1.3.0:

    • احصل على محتوى استجابة WeChat عند فشل التحقق من التوقيع، يتم طرح SignException.

  • 1.3.1:

    • إصلاح اسم حقل goods_tag .

  • 1.3.2:

    • إصلاح حقل clientIp إلى clientIp .

• المكونات ذات الصلة:

  • عنصر الدفع Alipay؛
  • مكون الحساب العام WeChat.

يرجى إنفاق المال إذا كان لديك شيء لتفعله

• أليباي:

  

• ويتشات: