wechat-pay 1.0.1 → 1.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e659dc3c1801cab85da470df5087895bd4a12e43d428f8fad282d2aba84022d2
-  data.tar.gz: f21c6f6ce72180bd0506bce69d2aae1e539dfbfbc1ddd69fc809d83719faa5f1
+  metadata.gz: 62c4aa7b22ada0f4b3251fdc6b28ba32620ca5149e7d999c458543a805dbcbef
+  data.tar.gz: d7f4b63d6e82df69d440154b233776e6a289b875a0ca81107440816732ec3dff
 SHA512:
-  metadata.gz: 7e1ac7d823df910753d26f52df615e82cef3ebaa8109dd299009fca5be48f7062361af7b2698a9b4a00fa4afc08d7ea8417677fb396e189d8efea54f309b5ad0
-  data.tar.gz: d6ec25bc79c1d1a96f0a9292b5045b7d52ebe41d0ba5c1cd50bd0cc8b6224460834833437f33d965225cce6190f74a5218ddcdace289b1702552bb79c6965cd5
+  metadata.gz: eddf42af769b7cf7781b991780b11deabe060e1bf4f2f86250e4a910b7483cafc779731ac03e12a6cc2ff9b9b97f81ff0e0ee8a83a177d5488d8ce68b727f6f0
+  data.tar.gz: 8a53231c6e6ead3ea36dffa157eba6bfeb73ae94762789d1261d852f92a60925764be70d9d1f8bf33b59a39aebc20fcff21b909e361cd64dc30621ea40f68ad9

data/lib/wechat-pay/direct.rb

@@ -7,585 +7,587 @@ module WechatPay
   module Direct
     include WechatPayHelper
 
-    class<<self
-      INVOKE_COMBINE_TRANSACTIONS_IN_APP_FIELDS = %i[combine_out_trade_no scene_info sub_orders notify_url].freeze # :nodoc:
-      #
-      # 直连合单app下单
-      #
-      # TODO: 与电商平台类似，只是参数不同，稍后重构
-      #
-      # Document: https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter5_1_1.shtml
-      #
-      # Example:
-      #
-      # ``` ruby
-      # params = {
-      #   combine_out_trade_no: 'combine_out_trade_no',
-      #   combine_payer_info: {
-      #     openid: 'client open id'
-      #   },
-      #   sub_orders: [
-      #     {
-      #       mchid: 'mchid',
-      #       sub_mchid: 'sub mchid',
-      #       attach: 'attach',
-      #       amount: {
-      #         total_amount: 100,
-      #         currency: 'CNY'
-      #       },
-      #       out_trade_no: 'out_trade_no',
-      #       description: 'description'
-      #     }
-      #   ],
-      #   notify_url: 'the_url'
-      # }
-      #
-      # WechatPay::Direct.invoke_combine_transactions_in_app(params)
-      # ```
-      def invoke_combine_transactions_in_app(params)
-        WechatPay::Ecommerce.invoke_combine_transactions_in_app(params)
-      end
-
-      INVOKE_COMBINE_TRANSACTIONS_IN_JS_FIELDS = %i[combine_out_trade_no scene_info sub_orders notify_url].freeze # :nodoc:
-      #
-      # 直连合单js下单
-      #
-      # TODO: 与电商平台类似，只是参数不同，稍后重构
-      #
-      # Document: https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter5_1_3.shtml
-      #
-      # Example:
-      #
-      # ``` ruby
-      # params = {
-      #   combine_out_trade_no: 'combine_out_trade_no',
-      #   combine_payer_info: {
-      #     openid: 'client open id'
-      #   },
-      #   sub_orders: [
-      #     {
-      #       mchid: 'mchid',
-      #       sub_mchid: 'sub mchid',
-      #       attach: 'attach',
-      #       amount: {
-      #         total_amount: 100,
-      #         currency: 'CNY'
-      #       },
-      #       out_trade_no: 'out_trade_no',
-      #       description: 'description'
-      #     }
-      #   ],
-      #   notify_url: 'the_url'
-      # }
-      #
-      # WechatPay::Direct.invoke_combine_transactions_in_js(params)
-      # ```
-      def invoke_combine_transactions_in_js(params)
-        WechatPay::Ecommerce.invoke_combine_transactions_in_js(params)
-      end
-
-      INVOKE_COMBINE_TRANSACTIONS_IN_H5_FIELDS = %i[combine_out_trade_no scene_info sub_orders notify_url].freeze # :nodoc:
-      #
-      # 直连合单h5下单
-      #
-      # TODO: 与电商平台类似，只是参数不同，稍后重构
-      #
-      # Document: https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter5_1_2.shtml
-      #
-      # Example:
-      #
-      # ``` ruby
-      # params = {
-      #   combine_out_trade_no: 'combine_out_trade_no',
-      #   sub_orders: [
-      #     {
-      #       mchid: 'mchid',
-      #       sub_mchid: 'sub mchid',
-      #       attach: 'attach',
-      #       amount: {
-      #         total_amount: 100,
-      #         currency: 'CNY'
-      #       },
-      #       out_trade_no: 'out_trade_no',
-      #       description: 'description'
-      #     }
-      #   ],
-      #   notify_url: 'the_url'
-      # }
-      #
-      # WechatPay::Direct.invoke_combine_transactions_in_h5(params)
-      # ```
-      def invoke_combine_transactions_in_h5(params)
-        WechatPay::Ecommerce.invoke_combine_transactions_in_h5(params)
-      end
-
-      INVOKE_COMBINE_TRANSACTIONS_IN_MINIPROGRAM_FIELDS = %i[combine_out_trade_no scene_info sub_orders notify_url].freeze # :nodoc:
-      #
-      # 直连合单小程序下单
-      #
-      # TODO: 与电商平台类似，只是参数不同，稍后重构
-      #
-      # Document: https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter5_1_4.shtml
-      #
-      # Example:
-      #
-      # ``` ruby
-      # params = {
-      #   combine_out_trade_no: 'combine_out_trade_no',
-      #   combine_payer_info: {
-      #     openid: 'client open id'
-      #   },
-      #   sub_orders: [
-      #     {
-      #       mchid: 'mchid',
-      #       sub_mchid: 'sub mchid',
-      #       attach: 'attach',
-      #       amount: {
-      #         total_amount: 100,
-      #         currency: 'CNY'
-      #       },
-      #       out_trade_no: 'out_trade_no',
-      #       description: 'description'
-      #     }
-      #   ],
-      #   notify_url: 'the_url'
-      # }
-      #
-      # WechatPay::Direct.invoke_combine_transactions_in_miniprogram(params)
-      # ```
-      def invoke_combine_transactions_in_miniprogram(params)
-        WechatPay::Ecommerce.invoke_combine_transactions_in_miniprogram(params)
-      end
-
-      INVOKE_COMBINE_TRANSACTIONS_IN_NATIVE_FIELDS = %i[combine_out_trade_no scene_info sub_orders notify_url].freeze # :nodoc:
-      #
-      # 直连合单native下单
-      #
-      # TODO: 与电商平台类似，只是参数不同，稍后重构
-      #
-      # Document: https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter5_1_5.shtml
-      #
-      # Example:
-      #
-      # ``` ruby
-      # params = {
-      #   combine_out_trade_no: 'combine_out_trade_no',
-      #   sub_orders: [
-      #     {
-      #       mchid: 'mchid',
-      #       sub_mchid: 'sub mchid',
-      #       attach: 'attach',
-      #       amount: {
-      #         total_amount: 100,
-      #         currency: 'CNY'
-      #       },
-      #       out_trade_no: 'out_trade_no',
-      #       description: 'description'
-      #     }
-      #   ],
-      #   notify_url: 'the_url'
-      # }
-      #
-      # WechatPay::Direct.invoke_combine_transactions_in_native(params)
-      # ```
-      def invoke_combine_transactions_in_native(params)
-        WechatPay::Ecommerce.invoke_combine_transactions_in_native(params)
-      end
-
-      QUERY_COMBINE_ORDER_FIELDS = %i[combine_out_trade_no].freeze # :nodoc:
-      #
-      # 合单查询
-      #
-      # TODO: 与电商平台相同，稍后重构
-      #
-      # Document: https://pay.weixin.qq.com/wiki/doc/apiv3_partner/apis/chapter7_3_11.shtml
-      #
-      # ``` ruby
-      # WechatPay::Direct.query_order(combine_out_trade_no: 'C202104302474')
-      # ```
-      #
-      def query_combine_order(params)
-        combine_out_trade_no = params.delete(:combine_out_trade_no)
-
-        url = "/v3/combine-transactions/out-trade-no/#{combine_out_trade_no}"
-
-        method = 'GET'
-
-        make_request(
-          method: method,
-          path: url,
-          extra_headers: {
-            'Content-Type' => 'application/x-www-form-urlencoded'
-          }
-        )
-      end
-
-      CLOSE_COMBINE_ORDER_FIELDS = %i[combine_out_trade_no sub_orders].freeze # :nodoc:
-      #
-      # 关闭合单
-      #
-      # TODO: 与电商平台相同，稍后重构
-      #
-      # Document: https://pay.weixin.qq.com/wiki/doc/apiv3_partner/apis/chapter7_3_11.shtml
-      #
-      # ``` ruby
-      # WechatPay::Direct.close_combine_order(combine_out_trade_no: 'C202104302474')
-      # ```
-      def close_combine_order(params)
-        combine_out_trade_no = params.delete(:combine_out_trade_no)
-
-        url = "/v3/combine-transactions/out-trade-no/#{combine_out_trade_no}/close"
-
-        payload = {
-          combine_appid: WechatPay.app_id
-        }.merge(params)
-
-        payload_json = payload.to_json
-
-        method = 'POST'
-
-        make_request(
-          method: method,
-          for_sign: payload_json,
-          payload: payload_json,
-          path: url
-        )
-      end
-
-      INVOKE_TRANSACTIONS_IN_JS_FIELDS = %i[description out_trade out_trade_no payer amount notify_url].freeze # :nodoc:
-      #
-      # 直连js下单
-      #
-      # Document: https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter3_1_1.shtml
-      #
-      # Example:
-      #
-      # ``` ruby
-      # params = {
-      #   appid: 'Your Open id',
-      #   mchid: 'Your Mch id'',
-      #   description: '回流',
-      #   out_trade_no: 'Checking',
-      #   payer: {
-      #     openid: 'oly6s5c'
-      #   },
-      #   amount: {
-      #     total: 1
-      #   },
-      #   notify_url: ENV['NOTIFICATION_URL']
-      # }
-      #
-      # WechatPay::Direct.invoke_transactions_in_js(params)
-      # ```
-      def invoke_transactions_in_js(params)
-        direct_transactions_method_by_suffix('jsapi', params)
-      end
-
-      INVOKE_TRANSACTIONS_IN_MINIPROGRAM_FIELDS = %i[description out_trade out_trade_no payer amount notify_url].freeze # :nodoc:
-      #
-      # 直连小程序下单
-      #
-      # Document:https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter3_5_1.shtml
-      #
-      # Example:
-      #
-      # ``` ruby
-      # params = {
-      #   appid: 'Your Open id',
-      #   mchid: 'Your Mch id'',
-      #   description: '回流',
-      #   out_trade_no: 'Checking',
-      #   payer: {
-      #     openid: 'oly6s5c'
-      #   },
-      #   amount: {
-      #     total: 1
-      #   },
-      #   notify_url: ENV['NOTIFICATION_URL']
-      # }
-      #
-      # WechatPay::Direct.invoke_transactions_in_miniprogram(params)
-      # ```
-      def invoke_transactions_in_miniprogram(params)
-        direct_transactions_method_by_suffix('jsapi', params)
+    ##
+    # :singleton-method: invoke_combine_transactions_in_app
+    #
+    # 直连合单app下单
+    #
+    #
+    # Document: https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter5_1_1.shtml
+    #
+    # Example:
+    #
+    # ``` ruby
+    # params = {
+    #   combine_out_trade_no: 'combine_out_trade_no',
+    #   combine_payer_info: {
+    #     openid: 'client open id'
+    #   },
+    #   sub_orders: [
+    #     {
+    #       mchid: 'mchid',
+    #       sub_mchid: 'sub mchid',
+    #       attach: 'attach',
+    #       amount: {
+    #         total_amount: 100,
+    #         currency: 'CNY'
+    #       },
+    #       out_trade_no: 'out_trade_no',
+    #       description: 'description'
+    #     }
+    #   ],
+    #   notify_url: 'the_url'
+    # }
+    #
+    # WechatPay::Direct.invoke_combine_transactions_in_app(params)
+    # ```
+
+    ##
+    # :singleton-method: invoke_combine_transactions_in_js
+    #
+    # js合单
+    #
+    # 直连合单js下单
+    #
+    # Document: https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter5_1_3.shtml
+    #
+    # Example:
+    #
+    # ``` ruby
+    # params = {
+    #   combine_out_trade_no: 'combine_out_trade_no',
+    #   combine_payer_info: {
+    #     openid: 'client open id'
+    #   },
+    #   sub_orders: [
+    #     {
+    #       mchid: 'mchid',
+    #       sub_mchid: 'sub mchid',
+    #       attach: 'attach',
+    #       amount: {
+    #         total_amount: 100,
+    #         currency: 'CNY'
+    #       },
+    #       out_trade_no: 'out_trade_no',
+    #       description: 'description'
+    #     }
+    #   ],
+    #   notify_url: 'the_url'
+    # }
+    #
+    # WechatPay::Direct.invoke_combine_transactions_in_js(params)
+    # ```
+
+    ##
+    # :singleton-method: invoke_combine_transactions_in_h5
+    #
+    # 直连合单h5下单
+    #
+    # TODO: 与电商平台类似，只是参数不同，稍后重构
+    #
+    # Document: https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter5_1_2.shtml
+    #
+    # Example:
+    #
+    # ``` ruby
+    # params = {
+    #   combine_out_trade_no: 'combine_out_trade_no',
+    #   sub_orders: [
+    #     {
+    #       mchid: 'mchid',
+    #       sub_mchid: 'sub mchid',
+    #       attach: 'attach',
+    #       amount: {
+    #         total_amount: 100,
+    #         currency: 'CNY'
+    #       },
+    #       out_trade_no: 'out_trade_no',
+    #       description: 'description'
+    #     }
+    #   ],
+    #   notify_url: 'the_url'
+    # }
+    #
+    # WechatPay::Direct.invoke_combine_transactions_in_h5(params)
+    # ```
+
+    ##
+    # :singleton-method: invoke_combine_transactions_in_miniprogram
+    #
+    # 直连合单小程序下单
+    #
+    #
+    # Document: https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter5_1_4.shtml
+    #
+    # Example:
+    #
+    # ``` ruby
+    # params = {
+    #   combine_out_trade_no: 'combine_out_trade_no',
+    #   combine_payer_info: {
+    #     openid: 'client open id'
+    #   },
+    #   sub_orders: [
+    #     {
+    #       mchid: 'mchid',
+    #       sub_mchid: 'sub mchid',
+    #       attach: 'attach',
+    #       amount: {
+    #         total_amount: 100,
+    #         currency: 'CNY'
+    #       },
+    #       out_trade_no: 'out_trade_no',
+    #       description: 'description'
+    #     }
+    #   ],
+    #   notify_url: 'the_url'
+    # }
+    #
+    # WechatPay::Direct.invoke_combine_transactions_in_miniprogram(params)
+    # ```
+
+    ##
+    # :singleton-method: invoke_combine_transactions_in_native
+    #
+    # 直连合单native下单
+    #
+    #
+    # Document: https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter5_1_5.shtml
+    #
+    # Example:
+    #
+    # ``` ruby
+    # params = {
+    #   combine_out_trade_no: 'combine_out_trade_no',
+    #   sub_orders: [
+    #     {
+    #       mchid: 'mchid',
+    #       sub_mchid: 'sub mchid',
+    #       attach: 'attach',
+    #       amount: {
+    #         total_amount: 100,
+    #         currency: 'CNY'
+    #       },
+    #       out_trade_no: 'out_trade_no',
+    #       description: 'description'
+    #     }
+    #   ],
+    #   notify_url: 'the_url'
+    # }
+    #
+    # WechatPay::Direct.invoke_combine_transactions_in_native(params)
+    # ```
+    {
+      js: 'jsapi',
+      app: 'app',
+      h5: 'h5',
+      native: 'native',
+      miniprogram: 'jsapi'
+    }.each do |key, _value|
+      const_set("INVOKE_COMBINE_TRANSACTIONS_IN_#{key.upcase}_FIELDS",
+                %i[combine_out_trade_no scene_info sub_orders notify_url].freeze)
+      define_singleton_method("invoke_combine_transactions_in_#{key}") do |params|
+        WechatPay::Ecommerce.send("invoke_combine_transactions_in_#{key}", params)
       end
+    end
 
-      INVOKE_TRANSACTIONS_IN_APP_FIELDS = %i[description out_trade out_trade_no payer amount notify_url].freeze # :nodoc:
-      #
-      # 直连APP下单
-      #
-      # Document: https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter3_2_1.shtml
-      #
-      # Example:
-      #
-      # ``` ruby
-      # params = {
-      #   appid: 'Your Open id',
-      #   mchid: 'Your Mch id'',
-      #   description: '回流',
-      #   out_trade_no: 'Checking',
-      #   payer: {
-      #     openid: 'oly6s5c'
-      #   },
-      #   amount: {
-      #     total: 1
-      #   },
-      #   notify_url: ENV['NOTIFICATION_URL']
-      # }
-      #
-      # WechatPay::Direct.invoke_transactions_in_app(params)
-      # ```
-      def invoke_transactions_in_app(params)
-        direct_transactions_method_by_suffix('app', params)
-      end
+    QUERY_COMBINE_ORDER_FIELDS = %i[combine_out_trade_no].freeze # :nodoc:
+    #
+    # 合单查询
+    #
+    # TODO: 与电商平台相同，稍后重构
+    #
+    # Document: https://pay.weixin.qq.com/wiki/doc/apiv3_partner/apis/chapter7_3_11.shtml
+    #
+    # ``` ruby
+    # WechatPay::Direct.query_order(combine_out_trade_no: 'C202104302474')
+    # ```
+    #
+    def self.query_combine_order(params)
+      combine_out_trade_no = params.delete(:combine_out_trade_no)
+
+      url = "/v3/combine-transactions/out-trade-no/#{combine_out_trade_no}"
+
+      method = 'GET'
+
+      make_request(
+        method: method,
+        path: url,
+        extra_headers: {
+          'Content-Type' => 'application/x-www-form-urlencoded'
+        }
+      )
+    end
 
-      INVOKE_TRANSACTIONS_IN_H5_FIELDS = %i[description out_trade out_trade_no payer amount notify_url].freeze # :nodoc:
-      #
-      # 直连h5下单
-      #
-      # Document: https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter3_3_1.shtml
-      #
-      # Example:
-      #
-      # ```
-      # params = {
-      #   appid: 'Your Open id',
-      #   mchid: 'Your Mch id'',
-      #   description: '回流',
-      #   out_trade_no: 'Checking',
-      #   payer: {
-      #     openid: 'oly6s5c'
-      #   },
-      #   amount: {
-      #     total: 1
-      #   },
-      #   notify_url: ENV['NOTIFICATION_URL']
-      # }
-      #
-      # WechatPay::Direct.invoke_transactions_in_h5(params)
-      # ```
-      def invoke_transactions_in_h5(params)
-        direct_transactions_method_by_suffix('h5', params)
-      end
+    CLOSE_COMBINE_ORDER_FIELDS = %i[combine_out_trade_no sub_orders].freeze # :nodoc:
+    #
+    # 关闭合单
+    #
+    # TODO: 与电商平台相同，稍后重构
+    #
+    # Document: https://pay.weixin.qq.com/wiki/doc/apiv3_partner/apis/chapter7_3_11.shtml
+    #
+    # ``` ruby
+    # WechatPay::Direct.close_combine_order(combine_out_trade_no: 'C202104302474')
+    # ```
+    def self.close_combine_order(params)
+      combine_out_trade_no = params.delete(:combine_out_trade_no)
+
+      url = "/v3/combine-transactions/out-trade-no/#{combine_out_trade_no}/close"
+
+      payload = {
+        combine_appid: WechatPay.app_id
+      }.merge(params)
+
+      payload_json = payload.to_json
+
+      method = 'POST'
+
+      make_request(
+        method: method,
+        for_sign: payload_json,
+        payload: payload_json,
+        path: url
+      )
+    end
 
-      INVOKE_TRANSACTIONS_IN_NATIVE_FIELDS = %i[description out_trade out_trade_no payer amount notify_url].freeze # :nodoc:
-      #
-      # 直连native下单
-      #
-      # Document: https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter3_4_1.shtml
-      #
-      # Example:
-      #
-      # ``` ruby
-      # params = {
-      #   appid: 'Your Open id',
-      #   mchid: 'Your Mch id'',
-      #   description: '回流',
-      #   out_trade_no: 'Checking',
-      #   payer: {
-      #     openid: 'oly6s5c'
-      #   },
-      #   amount: {
-      #     total: 1
-      #   },
-      #   notify_url: ENV['NOTIFICATION_URL']
-      # }
-      #
-      # WechatPay::Direct.invoke_transactions_in_native(params)
-      # ```
-      def invoke_transactions_in_native(params)
-        direct_transactions_method_by_suffix('native', params)
-      end
-
-      QUERY_ORDER_FIELDS = %i[out_trade_no transaction_id].freeze # :nodoc:
-      #
-      # 直连订单查询
-      #
-      # Document: https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter3_5_2.shtml
-      #
-      # Example:
-      #
-      # ``` ruby
-      # WechatPay::Direct.query_order(transaction_id: '4323400972202104305133344444') # by transaction_id
-      # WechatPay::Direct.query_order(out_trade_no: 'N202104302474') # by out_trade_no
-      # ```
-      #
-      def query_order(params)
-        if params[:transaction_id]
-          params.delete(:out_trade_no)
-          transaction_id = params.delete(:transaction_id)
-          path = "/v3/pay/transactions/id/#{transaction_id}"
-        else
-          params.delete(:transaction_id)
-          out_trade_no = params.delete(:out_trade_no)
-          path = "/v3/pay/transactions/out-trade-no/#{out_trade_no}"
-        end
-
-        params = params.merge({
-                                mchid: WechatPay.mch_id
-                              })
-
-        method = 'GET'
-        query = build_query(params)
-        url = "#{path}?#{query}"
-
-        make_request(
-          method: method,
-          path: url,
-          extra_headers: {
-            'Content-Type' => 'application/x-www-form-urlencoded'
-          }
-        )
+    ##
+    # :singleton-method: invoke_transactions_in_js
+    #
+    # 直连js下单
+    #
+    # Document: https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter3_1_1.shtml
+    #
+    # Example:
+    #
+    # ``` ruby
+    # params = {
+    #   appid: 'Your Open id',
+    #   mchid: 'Your Mch id'',
+    #   description: '回流',
+    #   out_trade_no: 'Checking',
+    #   payer: {
+    #     openid: 'oly6s5c'
+    #   },
+    #   amount: {
+    #     total: 1
+    #   },
+    #   notify_url: ENV['NOTIFICATION_URL']
+    # }
+    #
+    # WechatPay::Direct.invoke_transactions_in_js(params)
+    # ```
+
+    ##
+    # :singleton-method: invoke_transactions_in_miniprogram
+    #
+    # 直连小程序下单
+    #
+    # Document:https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter3_5_1.shtml
+    #
+    # Example:
+    #
+    # ``` ruby
+    # params = {
+    #   appid: 'Your Open id',
+    #   mchid: 'Your Mch id'',
+    #   description: '回流',
+    #   out_trade_no: 'Checking',
+    #   payer: {
+    #     openid: 'oly6s5c'
+    #   },
+    #   amount: {
+    #     total: 1
+    #   },
+    #   notify_url: ENV['NOTIFICATION_URL']
+    # }
+    #
+    # WechatPay::Direct.invoke_transactions_in_miniprogram(params)
+    # ```
+
+    ##
+    # :singleton-method: invoke_transactions_in_app
+    #
+    # 直连APP下单
+    #
+    # Document: https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter3_2_1.shtml
+    #
+    # Example:
+    #
+    # ``` ruby
+    # params = {
+    #   appid: 'Your Open id',
+    #   mchid: 'Your Mch id'',
+    #   description: '回流',
+    #   out_trade_no: 'Checking',
+    #   payer: {
+    #     openid: 'oly6s5c'
+    #   },
+    #   amount: {
+    #     total: 1
+    #   },
+    #   notify_url: ENV['NOTIFICATION_URL']
+    # }
+    #
+    # WechatPay::Direct.invoke_transactions_in_app(params)
+    # ```
+
+    ##
+    # :singleton-method: invoke_transactions_in_h5
+    #
+    # 直连h5下单
+    #
+    # Document: https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter3_3_1.shtml
+    #
+    # Example:
+    #
+    # ```
+    # params = {
+    #   appid: 'Your Open id',
+    #   mchid: 'Your Mch id'',
+    #   description: '回流',
+    #   out_trade_no: 'Checking',
+    #   payer: {
+    #     openid: 'oly6s5c'
+    #   },
+    #   amount: {
+    #     total: 1
+    #   },
+    #   notify_url: ENV['NOTIFICATION_URL']
+    # }
+    #
+    # WechatPay::Direct.invoke_transactions_in_h5(params)
+    # ```
+
+    ##
+    # :singleton-method: invoke_transactions_in_native
+    #
+    # 直连native下单
+    #
+    # Document: https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter3_4_1.shtml
+    #
+    # Example:
+    #
+    # ``` ruby
+    # params = {
+    #   appid: 'Your Open id',
+    #   mchid: 'Your Mch id'',
+    #   description: '回流',
+    #   out_trade_no: 'Checking',
+    #   payer: {
+    #     openid: 'oly6s5c'
+    #   },
+    #   amount: {
+    #     total: 1
+    #   },
+    #   notify_url: ENV['NOTIFICATION_URL']
+    # }
+    #
+    # WechatPay::Direct.invoke_transactions_in_native(params)
+    # ```
+    {
+      js: 'jsapi',
+      app: 'app',
+      h5: 'h5',
+      miniprogram: 'jsapi',
+      native: 'native'
+    }.each do |key, value|
+      const_set("INVOKE_TRANSACTIONS_IN_#{key.upcase}_FIELDS", %i[description out_trade out_trade_no payer amount notify_url].freeze)
+      define_singleton_method "invoke_transactions_in_#{key}" do |params|
+        direct_transactions_method_by_suffix(value, params)
       end
+    end
 
-      CLOSE_ORDER_FIELDS = %i[out_trade_no].freeze # :nodoc:
-      #
-      # 关闭订单
-      #
-      # Document: https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter3_5_3.shtml
-      #
-      # Example:
-      #
-      # ``` ruby
-      # WechatPay::Direct.close_order(out_trade_no: 'N3344445')
-      # ```
-      #
-      def close_order(params)
+    QUERY_ORDER_FIELDS = %i[out_trade_no transaction_id].freeze # :nodoc:
+    #
+    # 直连订单查询
+    #
+    # Document: https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter3_5_2.shtml
+    #
+    # Example:
+    #
+    # ``` ruby
+    # WechatPay::Direct.query_order(transaction_id: '4323400972202104305133344444') # by transaction_id
+    # WechatPay::Direct.query_order(out_trade_no: 'N202104302474') # by out_trade_no
+    # ```
+    #
+    def self.query_order(params)
+      if params[:transaction_id]
+        params.delete(:out_trade_no)
+        transaction_id = params.delete(:transaction_id)
+        path = "/v3/pay/transactions/id/#{transaction_id}"
+      else
+        params.delete(:transaction_id)
         out_trade_no = params.delete(:out_trade_no)
-        url = "/v3/pay/transactions/out-trade-no/#{out_trade_no}/close"
-        params = params.merge({
-                                mchid: WechatPay.mch_id
-                              })
-
-        method = 'POST'
-
-        make_request(
-          method: method,
-          path: url,
-          for_sign: params.to_json,
-          payload: params.to_json
-        )
+        path = "/v3/pay/transactions/out-trade-no/#{out_trade_no}"
       end
 
-      INVOKE_REFUND_FIELDS = %i[transaction_id out_trade_no out_refund_no amount].freeze # :nodoc:
-      #
-      # 退款申请
-      #
-      # Document: https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter3_5_9.shtml
-      #
-      # Example:
-      #
-      # ``` ruby
-      # WechatPay::Direct.invoke_refund(transaction_id: '4323400972202104305131070170', total: 1, refund: 1, out_refund_no: 'R10000')
-      # WechatPay::Direct.invoke_refund(out_trade_no: 'N2021', total: 1, refund: 1, out_refund_no: 'R10000').body
-      # ```
-      def invoke_refund(params)
-        url = '/v3/refund/domestic/refunds'
-        method = 'POST'
-        amount = {
-          refund: params.delete(:refund),
-          total: params.delete(:total),
-          currency: 'CNY'
-        }
+      params = params.merge({
+                              mchid: WechatPay.mch_id
+                            })
 
-        params = params.merge({
-                                amount: amount
-                              })
+      method = 'GET'
+      query = build_query(params)
+      url = "#{path}?#{query}"
 
-        make_request(
-          path: url,
-          method: method,
-          for_sign: params.to_json,
-          payload: params.to_json
-        )
-      end
-
-      QUERY_REFUND_FIELDS = %i[sub_mchid refund_id out_refund_no].freeze # :nodoc:
-      #
-      # 直连退款查询
-      #
-      # Document: https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter3_5_10.shtml
-      #
-      # Example:
-      #
-      # ``` ruby
-      # WechatPay::Direct.query_refund(out_refund_no: 'R10000')
-      # ```
-      #
-      def query_refund(params)
-        out_refund_no = params.delete(:out_refund_no)
-        url = "/v3/refund/domestic/refunds/#{out_refund_no}"
-
-        method = 'GET'
+      make_request(
+        method: method,
+        path: url,
+        extra_headers: {
+          'Content-Type' => 'application/x-www-form-urlencoded'
+        }
+      )
+    end
 
-        make_request(
-          method: method,
-          path: url,
-          extra_headers: {
-            'Content-Type' => 'application/x-www-form-urlencoded'
-          }
-        )
-      end
+    CLOSE_ORDER_FIELDS = %i[out_trade_no].freeze # :nodoc:
+    #
+    # 关闭订单
+    #
+    # Document: https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter3_5_3.shtml
+    #
+    # Example:
+    #
+    # ``` ruby
+    # WechatPay::Direct.close_order(out_trade_no: 'N3344445')
+    # ```
+    #
+    def self.close_order(params)
+      out_trade_no = params.delete(:out_trade_no)
+      url = "/v3/pay/transactions/out-trade-no/#{out_trade_no}/close"
+      params = params.merge({
+                              mchid: WechatPay.mch_id
+                            })
+
+      method = 'POST'
+
+      make_request(
+        method: method,
+        path: url,
+        for_sign: params.to_json,
+        payload: params.to_json
+      )
+    end
 
-      TRADEBILL_FIELDS = [:bill_date].freeze # :nodoc:
-      #
-      # 直连申请交易账单
-      #
-      # Todo: 跟商户平台接口相同
-      #
-      # Document: https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter3_5_6.shtml
-      #
-      # Example:
-      #
-      # ``` ruby
-      # WechatPay::direct.tradebill(bill_date: '2021-04-30')
-      # ```
-      def tradebill(params)
-        path = '/v3/bill/tradebill'
-        method = 'GET'
-
-        query = build_query(params)
-        url = "#{path}?#{query}"
+    INVOKE_REFUND_FIELDS = %i[transaction_id out_trade_no out_refund_no amount].freeze # :nodoc:
+    #
+    # 退款申请
+    #
+    # Document: https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter3_5_9.shtml
+    #
+    # Example:
+    #
+    # ``` ruby
+    # WechatPay::Direct.invoke_refund(transaction_id: '4323400972202104305131070170', total: 1, refund: 1, out_refund_no: 'R10000')
+    # WechatPay::Direct.invoke_refund(out_trade_no: 'N2021', total: 1, refund: 1, out_refund_no: 'R10000').body
+    # ```
+    def self.invoke_refund(params)
+      url = '/v3/refund/domestic/refunds'
+      method = 'POST'
+      amount = {
+        refund: params.delete(:refund),
+        total: params.delete(:total),
+        currency: 'CNY'
+      }
+
+      params = params.merge({
+                              amount: amount
+                            })
+
+      make_request(
+        path: url,
+        method: method,
+        for_sign: params.to_json,
+        payload: params.to_json
+      )
+    end
 
-        make_request(
-          path: url,
-          method: method,
-          extra_headers: {
-            'Content-Type' => 'application/x-www-form-urlencoded'
-          }
-        )
-      end
+    QUERY_REFUND_FIELDS = %i[sub_mchid refund_id out_refund_no].freeze # :nodoc:
+    #
+    # 直连退款查询
+    #
+    # Document: https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter3_5_10.shtml
+    #
+    # Example:
+    #
+    # ``` ruby
+    # WechatPay::Direct.query_refund(out_refund_no: 'R10000')
+    # ```
+    #
+    def self.query_refund(params)
+      out_refund_no = params.delete(:out_refund_no)
+      url = "/v3/refund/domestic/refunds/#{out_refund_no}"
+
+      method = 'GET'
+
+      make_request(
+        method: method,
+        path: url,
+        extra_headers: {
+          'Content-Type' => 'application/x-www-form-urlencoded'
+        }
+      )
+    end
 
-      FUNDFLOWBILL_FIELDS = [:bill_date].freeze # :nodoc:
-      #
-      # 申请资金账单
-      #
-      # Todo: 跟商户平台接口相同
-      #
-      # Document: https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter3_5_7.shtml
-      #
-      # Example:
-      #
-      # ``` ruby
-      # WechatPay::Direct.fundflowbill(bill_date: '2021-04-30')
-      # ```
-      #
-      def fundflowbill(params)
-        path = '/v3/bill/fundflowbill'
-        method = 'GET'
-
-        query = build_query(params)
-        url = "#{path}?#{query}"
+    TRADEBILL_FIELDS = [:bill_date].freeze # :nodoc:
+    #
+    # 直连申请交易账单
+    #
+    # Todo: 跟商户平台接口相同
+    #
+    # Document: https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter3_5_6.shtml
+    #
+    # Example:
+    #
+    # ``` ruby
+    # WechatPay::direct.tradebill(bill_date: '2021-04-30')
+    # ```
+    def self.tradebill(params)
+      path = '/v3/bill/tradebill'
+      method = 'GET'
+
+      query = build_query(params)
+      url = "#{path}?#{query}"
+
+      make_request(
+        path: url,
+        method: method,
+        extra_headers: {
+          'Content-Type' => 'application/x-www-form-urlencoded'
+        }
+      )
+    end
 
-        make_request(
-          path: url,
-          method: method,
-          extra_headers: {
-            'Content-Type' => 'application/x-www-form-urlencoded'
-          }
-        )
-      end
+    FUNDFLOWBILL_FIELDS = [:bill_date].freeze # :nodoc:
+    #
+    # 申请资金账单
+    #
+    # Todo: 跟商户平台接口相同
+    #
+    # Document: https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter3_5_7.shtml
+    #
+    # Example:
+    #
+    # ``` ruby
+    # WechatPay::Direct.fundflowbill(bill_date: '2021-04-30')
+    # ```
+    #
+    def self.fundflowbill(params)
+      path = '/v3/bill/fundflowbill'
+      method = 'GET'
+
+      query = build_query(params)
+      url = "#{path}?#{query}"
+
+      make_request(
+        path: url,
+        method: method,
+        extra_headers: {
+          'Content-Type' => 'application/x-www-form-urlencoded'
+        }
+      )
+    end
 
+    class << self
       private
 
       def direct_transactions_method_by_suffix(suffix, params)