wepay

Nous payons

Un composant de paiement Wechat léger

• Importation de packages :

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

• Packages dépendants, faites attention à savoir si vous devez les exclure lors de l'introduction du projet :

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

• Utilisation de base :

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

• Composants implémentés :

  • Payer pay() ;
  • Remboursement refund() ;
  • order() ;
  • Notifier notify() ;
  • bill() .

• Documentation API ici.

• À propos des tests :

  • Les cas de test incluent quelques tests de base qui nécessitent une certaine configuration :

     // 在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 ();

  • Le projet wepay-demo est un projet Web exécutable, pratique pour les tests. Vous pouvez le tester en suivant les étapes suivantes. Copiez app-example.properties dans wepay-demo dans app.properties et configurez-le en conséquence :

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

  • Remarque : ** payNotifyUrl ** doit être configuré comme une adresse que le serveur WeChat peut appeler depuis le réseau externe. Pour les tests locaux, il est recommandé d'utiliser l'outil ngrok pour le mappage du réseau local et externe.

  • Accédez au répertoire racine wepay-demo et exécutez la commande suivante :

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

  • Le paiement par code QR dynamique est accessible ( une fois la demande normale, l'image du code QR générée par Liantu apparaîtra. Une fois le paiement réussi par numérisation avec WeChat, la notification correspondante Notifies sera reçue en arrière-plan ) :

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

  • Le remboursement est accessible ( après une soumission réussie, un message sera notifié sur WeChat ) :

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

• Documents associés :

  • Document de paiement WeChat.

• Version historique :

  • 1.0.0 :

    • Les fonctions de base sont implémentées.

  • 1.1.0 :

    • Ajouter une demande de facture.

  • 1.1.1 :

    • Correction du prepayId.

  • 1.1.2 :

    • Correction du problème de signature de paiement JS/APP.

  • 1.2.2 :

    • Champs de requête de remboursement ajoutés : statut du remboursement, montant du remboursement, partie du compte de remboursement.

  • 1.2.3 :

    • corriger isNullOrEmpty.

  • 1.2.4 :

    • Après la mise à niveau du commun vers 1.1.2, vous pouvez configurer le type d'encodage pour l'analyse du XML WeChat. La valeur par défaut est UTF-8 pour éviter toute incohérence avec l'encodage par défaut local.

  • 1.2.5 :

    • Le résultat du paiement par code QR est mis à jour vers QrPayResponse et le champ prepay_id est ajouté.

  • 1.3.0 :

    • Obtenez le contenu de la réponse WeChat. Lorsque la vérification de la signature échoue, une SignException est levée.

  • 1.3.1 :

    • Corrigez le nom du champ goods_tag .

  • 1.3.2 :

    • Corrigez le champ clientIp sur clientIp .

• Composants associés :

  • Composant de paiement Alipay ;
  • Composant de compte public WeChat.

S'il vous plaît, dépensez de l'argent si vous avez quelque chose à faire

• Alipay :

  

• WeChat :