wechat-pay 1.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: e659dc3c1801cab85da470df5087895bd4a12e43d428f8fad282d2aba84022d2
+  data.tar.gz: f21c6f6ce72180bd0506bce69d2aae1e539dfbfbc1ddd69fc809d83719faa5f1
+SHA512:
+  metadata.gz: 7e1ac7d823df910753d26f52df615e82cef3ebaa8109dd299009fca5be48f7062361af7b2698a9b4a00fa4afc08d7ea8417677fb396e189d8efea54f309b5ad0
+  data.tar.gz: d6ec25bc79c1d1a96f0a9292b5045b7d52ebe41d0ba5c1cd50bd0cc8b6224460834833437f33d965225cce6190f74a5218ddcdace289b1702552bb79c6965cd5

data/lib/set_base_envrionment.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+WechatPay.apiclient_key = File.read('./apiclient_key.pem')
+WechatPay.platform_cert = File.read('platform_cert.pem')
+WechatPay.apiclient_cert = File.read('apiclient_cert.pem')
+WechatPay.app_id = 'wxf50e9a05a23a7624'
+WechatPay.mch_id = '1607189890'
+WechatPay.mch_key = 'b76a5cc5fae2d222dba6caf5537204c4'

data/lib/wechat-pay.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+require 'restclient'
+require 'wechat-pay/sign'
+require 'wechat-pay/direct' # 直连模式
+require 'wechat-pay/ecommerce' # 电商平台
+
+# # 微信支付
+#
+# 设置关键信息
+
+module WechatPay
+  class<< self
+    attr_accessor :app_id, :mch_id, :mch_key
+    attr_reader :apiclient_key, :apiclient_cert, :platform_cert
+
+    # 设置商户私钥，从微信商户平台下载
+    def apiclient_key=(key)
+      @apiclient_key = OpenSSL::PKey::RSA.new(key)
+    end
+
+    # 设置平台证书，通过接口获取 https://github.com/lanzhiheng/wechat-pay/blob/master/lib/wechat-pay/ecommerce/applyment.rb#L116
+    def platform_cert=(cert)
+      @platform_cert = OpenSSL::X509::Certificate.new(cert)
+    end
+
+    # 设置商户证书，从微信商户平台下载
+    def apiclient_cert=(cert)
+      @apiclient_cert = OpenSSL::X509::Certificate.new(cert)
+    end
+
+    # 平台证书序列号
+    def platform_serial_no
+      @platform_serial_no ||= platform_cert.serial.to_s(16)
+    end
+
+    # 商户证书序列号
+    def apiclient_serial_no
+      @apiclient_serial_no ||= apiclient_cert.serial.to_s(16)
+    end
+  end
+end

data/lib/wechat-pay/direct.rb

@@ -0,0 +1,611 @@
+require 'json'
+require 'wechat-pay/helper'
+
+module WechatPay
+  # # 直连商户相关接口封装（常用的已有，待完善）
+  # 文档: https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter3_1_1.shtml
+  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)
+      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
+
+      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
+
+      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'
+          }
+        )
+      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)
+        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
+
+      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({
+                                amount: amount
+                              })
+
+        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
+
+      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}"
+
+        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 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
+
+      private
+
+      def direct_transactions_method_by_suffix(suffix, params)
+        url = "/v3/pay/transactions/#{suffix}"
+        method = 'POST'
+
+        params = params.merge({
+                                mchid: WechatPay.mch_id,
+                                appid: WechatPay.app_id
+                              })
+
+        payload_json = params.to_json
+
+        make_request(
+          method: method,
+          path: url,
+          for_sign: payload_json,
+          payload: payload_json
+        )
+      end
+    end
+  end
+end