alipay-easysdk-ruby 1.0.1 → 1.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c2b04a16730b90788a7d0c75911eb49750f253f1a40cf6efab4a81696a31cf9b
-  data.tar.gz: c66dfd5f038def8e6462b1cf2faa61f2f5fd42c42b2eea9b9426977b123a3eb9
+  metadata.gz: 9fbf7bcd464b1d9f4c42aaec6030ba6dfc9a4beda7eb5c3ea2587722b2fdff01
+  data.tar.gz: 43c10156f010ca3f98696361f9d9a07478bd1ea44c1533a086f5c2c066956c9b
 SHA512:
-  metadata.gz: a97a34c94daf4056fe0b7d102db422bc3080c16f74f19b1e438f1e8e5993dc3288b5a552854d6e0898185f9f40609f529956250e0a363f1622a5a2cbd40593dd
-  data.tar.gz: 28dc7cda0b59867844a27ca7871ee27cbcbf5bfc3b5908ec17c522b683e56300bd79a38f916ef87b3b275772264b715133ff344644a550e166831dc657ea2362
+  metadata.gz: d10e78d464ea90c15a6b9e17bcbbf1e6414fb3a842eda95f2662e69e3de245e6209214b096b8b3dd38f8bd0daefcd4c12b664b8947de02feb544b83f0be41b8e
+  data.tar.gz: fddc8561482df008189ba3cfcd93fc3751e1ea192d07c9008f201ee6c211f780da96ddd2de9d90395c48d575481e8f50c766a63e0792b05c1c55f5992f95d728

data/CHANGELOG.md

@@ -0,0 +1,20 @@
+# Changelog
+
+## 1.0.3 - 2024-06-06
+
+- Add `payment/app` client and response model to match PHP EasySDK behaviour.
+- Align kernel utilities (Config, Factory, EasySDKKernel, PageUtil, AES, Signer, JsonUtil, ResponseChecker) with the PHP implementation.
+- Update Payment::Common/Page/Wap clients and models to PHP parity while retaining the custom `payment_url` extension.
+- Refresh parity fixtures, expand test coverage, and remove the deprecated `examples/` directory.
+
+## 1.0.2 - 2024-04-15
+
+- Align `payment/page`, `payment/wap`, and `payment/common` dependencies with the PHP EasySDK implementation.
+- Extend `Kernel::Config` to support certificate paths, proxy, notify URL, and encryption settings used by PHP clients.
+- Introduce certificate environment utilities to derive certificate serial numbers and cached public keys.
+- Update `Payment::Common::Client` to honour proxy and SSL settings and improve parity with PHP HTTP behaviour.
+- Add comprehensive test coverage for certificate handling, extended configuration, and HTTP proxy behaviour.
+
+## 1.0.1 - 2024-03-01
+
+- Initial public release of the Ruby EasySDK port.

data/lib/alipay/easysdk/kernel/alipay_constants.rb

@@ -4,41 +4,39 @@ module Alipay
   module EasySDK
     module Kernel
       module AlipayConstants
-        DEFAULT_CHARSET = "UTF-8"
-
-        # 签名类型
-        SIGN_TYPE_RSA = "RSA"
-        SIGN_TYPE_RSA2 = "RSA2"
+        # Config键名（对齐PHP版）
+        PROTOCOL_CONFIG_KEY = "protocol"
+        HOST_CONFIG_KEY = "gatewayHost"
+        ALIPAY_CERT_PATH_CONFIG_KEY = "alipayCertPath"
+        MERCHANT_CERT_PATH_CONFIG_KEY = "merchantCertPath"
+        ALIPAY_ROOT_CERT_PATH_CONFIG_KEY = "alipayRootCertPath"
+        SIGN_TYPE_CONFIG_KEY = "signType"
+        NOTIFY_URL_CONFIG_KEY = "notifyUrl"
 
-        # 字段常量
-        APP_ID_FIELD = "app_id"
-        METHOD_FIELD = "method"
-        FORMAT_FIELD = "format"
-        TIMESTAMP_FIELD = "timestamp"
-        VERSION_FIELD = "version"
-        SIGN_TYPE_FIELD = "sign_type"
-        SIGN_FIELD = "sign"
+        # 与网关交互使用的字段
         BIZ_CONTENT_FIELD = "biz_content"
-        CHARSET_FIELD = "charset"
-        BODY_FIELD = "body"
         ALIPAY_CERT_SN_FIELD = "alipay_cert_sn"
+        SIGN_FIELD = "sign"
+        BODY_FIELD = "http_body"
         NOTIFY_URL_FIELD = "notify_url"
-        NOTIFY_URL_CONFIG_KEY = "notifyUrl"
-        PROTOCOL_CONFIG_KEY = "protocol"
-        HOST_CONFIG_KEY = "gatewayHost"
+        METHOD_FIELD = "method"
         RESPONSE_SUFFIX = "_response"
         ERROR_RESPONSE = "error_response"
 
-        # 默认值
+        DEFAULT_CHARSET = "UTF-8"
         DEFAULT_FORMAT = "json"
         DEFAULT_VERSION = "1.0"
-        DEFAULT_SIGN_TYPE = SIGN_TYPE_RSA2
+        DEFAULT_SIGN_TYPE = "RSA2"
+
+        SIGN_TYPE_RSA = "RSA"
+        SIGN_TYPE_RSA2 = "RSA2"
+        RSA2 = "RSA2"
+        SHA_256_WITH_RSA = "SHA256WithRSA"
+        RSA = "RSA"
 
-        # 请求方式
         GET = "GET"
         POST = "POST"
 
-        # SDK信息
         SDK_VERSION = "alipay-easysdk-ruby-#{Alipay::EasySDK::VERSION}"
       end
     end

data/lib/alipay/easysdk/kernel/cert_environment.rb

@@ -0,0 +1,35 @@
+require 'openssl'
+require 'digest/md5'
+
+require_relative 'util/ant_certification_util'
+
+module Alipay
+  module EasySDK
+    module Kernel
+      class CertEnvironment
+        attr_reader :root_cert_sn, :merchant_cert_sn
+
+        def initialize
+          @cert_util = Util::AntCertificationUtil.new
+          @root_cert_sn = nil
+          @merchant_cert_sn = nil
+          @cached_alipay_public_key = nil
+        end
+
+        def setup(merchant_cert_path, alipay_cert_path, alipay_root_cert_path)
+          if [merchant_cert_path, alipay_cert_path, alipay_root_cert_path].any? { |path| path.nil? || path.to_s.strip.empty? }
+            raise RuntimeError, '证书参数merchantCertPath、alipayCertPath或alipayRootCertPath设置不完整。'
+          end
+
+          @root_cert_sn = @cert_util.root_cert_sn(alipay_root_cert_path)
+          @merchant_cert_sn = @cert_util.cert_sn(merchant_cert_path)
+          @cached_alipay_public_key = @cert_util.public_key(alipay_cert_path)
+        end
+
+        def cached_alipay_public_key
+          @cached_alipay_public_key
+        end
+      end
+    end
+  end
+end

data/lib/alipay/easysdk/kernel/config.rb

@@ -1,36 +1,107 @@
-require_relative 'alipay_constants'
-
 module Alipay
   module EasySDK
     module Kernel
       class Config
-        attr_accessor :protocol, :gateway_host, :app_id, :merchant_private_key,
-                      :alipay_public_key, :sign_type, :charset, :format, :version,
-                      :merchant_cert_sn, :alipay_root_cert_sn, :notify_url
-
-        def initialize(options = {})
-          @protocol = options[:protocol] || 'https'
-          @gateway_host = options[:gateway_host] || 'openapi.alipay.com/gateway.do'
-          @app_id = options[:app_id]
-          @merchant_private_key = options[:merchant_private_key]
-          @alipay_public_key = options[:alipay_public_key]
-          @sign_type = options[:sign_type] || AlipayConstants::DEFAULT_SIGN_TYPE
-          @charset = options[:charset] || AlipayConstants::DEFAULT_CHARSET
-          @format = options[:format] || AlipayConstants::DEFAULT_FORMAT
-          @version = options[:version] || AlipayConstants::DEFAULT_VERSION
-          @merchant_cert_sn = options[:merchant_cert_sn]
-          @alipay_root_cert_sn = options[:alipay_root_cert_sn]
-          @notify_url = options[:notify_url]
+        attr_accessor :protocol,
+                      :gatewayHost,
+                      :appId,
+                      :signType,
+                      :alipayPublicKey,
+                      :merchantPrivateKey,
+                      :merchantCertPath,
+                      :alipayCertPath,
+                      :alipayRootCertPath,
+                      :merchantCertSN,
+                      :alipayCertSN,
+                      :alipayRootCertSN,
+                      :notifyUrl,
+                      :encryptKey,
+                      :httpProxy,
+                      :ignoreSSL
+
+        def initialize(options = nil)
+          assign_attributes(options) if options
+        end
+
+        # 下划线风格的访问器保持向后兼容
+        alias_method :gateway_host, :gatewayHost
+        alias_method :gateway_host=, :gatewayHost=
+
+        alias_method :app_id, :appId
+        alias_method :app_id=, :appId=
+
+        alias_method :sign_type, :signType
+        alias_method :sign_type=, :signType=
+
+        alias_method :alipay_public_key, :alipayPublicKey
+        alias_method :alipay_public_key=, :alipayPublicKey=
+
+        alias_method :merchant_private_key, :merchantPrivateKey
+        alias_method :merchant_private_key=, :merchantPrivateKey=
+
+        alias_method :merchant_cert_path, :merchantCertPath
+        alias_method :merchant_cert_path=, :merchantCertPath=
+
+        alias_method :alipay_cert_path, :alipayCertPath
+        alias_method :alipay_cert_path=, :alipayCertPath=
+
+        alias_method :alipay_root_cert_path, :alipayRootCertPath
+        alias_method :alipay_root_cert_path=, :alipayRootCertPath=
+
+        alias_method :merchant_cert_sn, :merchantCertSN
+        alias_method :merchant_cert_sn=, :merchantCertSN=
+
+        alias_method :alipay_cert_sn, :alipayCertSN
+        alias_method :alipay_cert_sn=, :alipayCertSN=
+
+        alias_method :alipay_root_cert_sn, :alipayRootCertSN
+        alias_method :alipay_root_cert_sn=, :alipayRootCertSN=
+
+        alias_method :notify_url, :notifyUrl
+        alias_method :notify_url=, :notifyUrl=
+
+        alias_method :encrypt_key, :encryptKey
+        alias_method :encrypt_key=, :encryptKey=
+
+        alias_method :http_proxy, :httpProxy
+        alias_method :http_proxy=, :httpProxy=
+
+        alias_method :ignore_ssl, :ignoreSSL
+        alias_method :ignore_ssl=, :ignoreSSL=
+
+        private
+
+        def assign_attributes(options)
+          options.each do |key, value|
+            setter = attribute_writer_for(key)
+            public_send(setter, value) if setter && respond_to?(setter, true)
+          end
+        end
+
+        def attribute_writer_for(key)
+          string_key = key.to_s
+          writer = "#{string_key}="
+          return writer if respond_to?(writer, true)
+
+          camel_case = underscore_to_camel(string_key)
+          writer = "#{camel_case}="
+          return writer if respond_to?(writer, true)
+
+          snake_case = camel_to_snake(string_key)
+          writer = "#{snake_case}="
+          return writer if respond_to?(writer, true)
+
+          nil
         end
 
-        def gateway_url
-          "#{@protocol}://#{@gateway_host}"
+        def underscore_to_camel(str)
+          str.split('_').inject do |memo, part|
+            memo + part.capitalize
+          end
         end
 
-        def validate
-          raise "app_id is required" if @app_id.nil? || @app_id.empty?
-          raise "merchant_private_key is required" if @merchant_private_key.nil? || @merchant_private_key.empty?
-          raise "alipay_public_key is required" if @alipay_public_key.nil? || @alipay_public_key.empty?
+        def camel_to_snake(str)
+          str.gsub(/([A-Z]+)/) { "_#{$1.downcase}" }.sub(/^_/, '')
         end
       end
     end

data/lib/alipay/easysdk/kernel/easy_sdk_kernel.rb

@@ -3,9 +3,12 @@ require_relative 'config'
 require_relative 'util/json_util'
 require_relative 'util/signer'
 require_relative 'util/sign_content_extractor'
+require_relative 'util/aes'
+require_relative 'util/page_util'
 require 'net/http'
 require 'uri'
 require 'cgi'
+require 'json'
 
 module Alipay
   module EasySDK
@@ -38,28 +41,16 @@ module Alipay
       end
 
       def get_config(key)
-        case key
-        when 'protocol'
-          @config.protocol
-        when 'gatewayHost'
-          @config.gateway_host
-        when 'appId'
-          @config.app_id
-        when 'merchantPrivateKey'
-          @config.merchant_private_key
-        when 'alipayPublicKey'
-          @config.alipay_public_key
-        when 'signType'
-          @config.sign_type
-        when 'charset'
-          @config.charset
-        when 'format'
-          @config.format
-        when 'version'
-          @config.version
-        else
-          nil
-        end
+        method = key.to_s
+        return @config.public_send(method) if @config.respond_to?(method)
+
+        snake = method.gsub(/([A-Z]+)/) { "_#{$1.downcase}" }.sub(/^_/, '')
+        return @config.public_send(snake) if @config.respond_to?(snake)
+
+        camel = snake.split('_').inject { |memo, part| memo + part.capitalize }
+        return @config.public_send(camel) if camel && @config.respond_to?(camel)
+
+        nil
       end
 
       def get_sdk_version
@@ -77,9 +68,9 @@ module Alipay
       def read_as_json(response, method)
         response_body = response.body
         map = {}
-        map['body'] = response_body
-        map['method'] = method
-        return map
+        map[AlipayConstants::BODY_FIELD] = response_body
+        map[AlipayConstants::METHOD_FIELD] = method
+        map
       end
 
       def get_random_boundary
@@ -89,11 +80,12 @@ module Alipay
       def generate_page(method, system_params, biz_params, text_params, sign)
         puts "[DEBUG] generate_page - sign长度: #{sign.length}" if ENV['DEBUG']
         signed_params = build_signed_params(system_params, biz_params, text_params, sign)
-        if method == 'GET'
-          return build_gateway_url(signed_params)
-        elsif method == 'POST'
+        case method
+        when AlipayConstants::GET
+          build_gateway_url(signed_params)
+        when AlipayConstants::POST
           puts "[DEBUG] generate_page POST - sorted_map中sign长度: #{signed_params[AlipayConstants::SIGN_FIELD].length}" if ENV['DEBUG']
-          return build_form(get_gateway_server_url, signed_params)
+          build_form(get_gateway_server_url, signed_params)
         else
           raise "不支持" + method
         end
@@ -110,8 +102,8 @@ module Alipay
 
       def get_alipay_cert_sn(resp_map)
         if !@config.merchant_cert_sn.nil? && !@config.merchant_cert_sn.empty?
-          body = JSON.parse(resp_map['body'])
-          alipay_cert_sn = body['alipay_cert_sn']
+          body = JSON.parse(resp_map[AlipayConstants::BODY_FIELD])
+          alipay_cert_sn = body[AlipayConstants::ALIPAY_CERT_SN_FIELD]
           return alipay_cert_sn
         end
       end
@@ -130,10 +122,10 @@ module Alipay
       end
 
       def verify(resp_map, alipay_public_key)
-        resp = JSON.parse(resp_map['body'])
+        resp = JSON.parse(resp_map[AlipayConstants::BODY_FIELD])
         sign = resp[AlipayConstants::SIGN_FIELD]
         sign_content_extractor = Alipay::EasySDK::Kernel::Util::SignContentExtractor.new
-        content = sign_content_extractor.get_sign_source_data(resp_map['body'], resp_map['method'])
+        content = sign_content_extractor.get_sign_source_data(resp_map[AlipayConstants::BODY_FIELD], resp_map[AlipayConstants::METHOD_FIELD])
         signer = Alipay::EasySDK::Kernel::Util::Signer.new
         return signer.verify(content, sign, alipay_public_key)
       end
@@ -158,18 +150,55 @@ module Alipay
         URI.encode_www_form(sorted_map)
       end
 
+      def to_multipart_request_body(text_params, file_params, boundary)
+        @text_params = text_params
+        @biz_params = nil
+        if text_params != nil && !@optional_text_params.empty?
+          @text_params = text_params.merge(@optional_text_params)
+        elsif text_params == nil
+          @text_params = @optional_text_params.dup
+        end
+
+        parts = []
+        (@text_params || {}).each do |key, value|
+          parts << build_multipart_text_part(boundary, key, value)
+        end
+
+        (file_params || {}).each do |key, path|
+          raise "文件#{path}不存在" unless File.exist?(path.to_s)
+          file_content = File.binread(path)
+          filename = File.basename(path)
+          parts << build_multipart_file_part(boundary, key, filename, file_content)
+        end
+
+        return nil if parts.empty?
+
+        parts << "--#{boundary}--\r\n"
+        parts.join
+      end
+
+      def aes_encrypt(content, encrypt_key)
+        aes = Alipay::EasySDK::Kernel::Util::AES.new
+        aes.aes_encrypt(content, encrypt_key)
+      end
+
+      def aes_decrypt(content, encrypt_key)
+        aes = Alipay::EasySDK::Kernel::Util::AES.new
+        aes.aes_decrypt(content, encrypt_key)
+      end
+
       def sort_map(random_map)
         return random_map
       end
 
       def to_resp_model(resp_map)
-        body = resp_map['body']
-        method_name = resp_map['method']
+        body = resp_map[AlipayConstants::BODY_FIELD]
+        method_name = resp_map[AlipayConstants::METHOD_FIELD]
         response_node_name = method_name.gsub(".", "_") + "_response"
 
         model = JSON.parse(body)
-        if body.include?("error_response")
-          result = model["error_response"]
+        if body.include?(AlipayConstants::ERROR_RESPONSE)
+          result = model[AlipayConstants::ERROR_RESPONSE]
           result['body'] = body
         else
           result = model[response_node_name]
@@ -216,15 +245,15 @@ module Alipay
           @biz_params = @optional_biz_params
         end
 
-        json = Alipay::EasySDK::Kernel::Util::JsonUtil.new
-        if @biz_params != nil
-          biz_params = json.to_json_string(@biz_params)
-        end
-        sorted_map = system_params || {}
-        if !biz_params.nil? && !biz_params.empty?
-          # 模拟PHP json_encode($bizParams, JSON_UNESCAPED_UNICODE)
-          json_string = JSON.generate(JSON.parse(biz_params)).gsub('/', "\\/")
-          sorted_map[AlipayConstants::BIZ_CONTENT_FIELD] = json_string
+        json_util = Alipay::EasySDK::Kernel::Util::JsonUtil.new
+        biz_content = json_util.to_json_string(@biz_params) unless @biz_params.nil?
+
+        sorted_map = (system_params || {}).dup
+        if !biz_content.nil?
+          unless biz_content.respond_to?(:empty?) && biz_content.empty?
+            serialized = JSON.generate(biz_content, ascii_only: false).gsub('/', '\\/')
+            sorted_map[AlipayConstants::BIZ_CONTENT_FIELD] = serialized
+          end
         end
         if !@text_params.nil? && !@text_params.empty?
           if !sorted_map.empty?
@@ -233,15 +262,19 @@ module Alipay
             sorted_map = @text_params
           end
         end
-        if get_config('notify_url') != nil
-          sorted_map['notify_url'] = get_config('notify_url')
+        notify_value = get_config(AlipayConstants::NOTIFY_URL_CONFIG_KEY)
+        if !notify_value.nil? && notify_value.to_s.strip != ''
+          sorted_map[AlipayConstants::NOTIFY_URL_FIELD] = notify_value
         end
         return sorted_map
       end
 
       def get_sign_content(params)
         # 模拟PHP的ksort
-        sorted_params = params.sort_by { |k, _| k.to_s }.to_h
+        normalized = params.each_with_object({}) do |(key, value), acc|
+          acc[key.to_s] = value
+        end
+        sorted_params = normalized.sort.to_h
 
         string_to_be_signed = ""
         i = 0
@@ -261,7 +294,9 @@ module Alipay
       end
 
       def get_gateway_server_url
-        return get_config('protocol') + '://' + get_config('gatewayHost').gsub('/gateway.do', '') + '/gateway.do'
+        protocol = get_config(AlipayConstants::PROTOCOL_CONFIG_KEY)
+        host = get_config(AlipayConstants::HOST_CONFIG_KEY)
+        return protocol + '://' + host.gsub('/gateway.do', '') + '/gateway.do'
       end
 
       def check_empty(value)
@@ -302,25 +337,8 @@ module Alipay
         puts "[DEBUG] build_form - 原始params keys: #{params.keys.join(', ')}" if ENV['DEBUG']
         puts "[DEBUG] build_form - sign长度: #{params[AlipayConstants::SIGN_FIELD].length}" if ENV['DEBUG'] && params[AlipayConstants::SIGN_FIELD]
 
-        # 完全按照PHP版本的PageUtil::buildForm方法：过滤空值参数
-        form_fields = ""
-        params.each do |key, val|
-          if !check_empty(val)  # 与PHP版本的checkEmpty逻辑完全一致
-            # 按照PHP版本：将单引号替换为&amp;apos;
-            escaped_val = val.to_s.gsub("'", "&apos;")
-            form_fields += "<input type='hidden' name='#{key}' value='#{escaped_val}'/>"
-          end
-        end
-
-        # 完全按照PHP版本：在action URL中添加charset参数
-        action_url = "#{url}?charset=#{AlipayConstants::DEFAULT_CHARSET}"
-
-        <<~HTML
-          <form id='alipaysubmit' name='alipaysubmit' action='#{action_url}' method='POST'>
-            #{form_fields}
-            <input type='submit' value='ok' style='display:none;'></form>
-          <script>document.forms['alipaysubmit'].submit();</script>
-        HTML
+        page_util = Alipay::EasySDK::Kernel::Util::PageUtil.new
+        page_util.build_form(url, params)
       end
 
       def build_signed_params(system_params, biz_params, text_params, sign)
@@ -330,10 +348,25 @@ module Alipay
       end
 
       def build_gateway_url(signed_params)
-        base_url = get_gateway_server_url + "?charset=#{AlipayConstants::DEFAULT_CHARSET}"
+        base_url = get_gateway_server_url
         query = build_query_string(signed_params)
         return base_url if query.nil? || query.empty?
-        base_url + '&' + query
+        base_url + '?' + query
+      end
+
+      def build_multipart_text_part(boundary, key, value)
+        "--#{boundary}\r\n" \
+          "Content-Disposition: form-data; name=\"#{key}\"\r\n" \
+          "\r\n" \
+          "#{value}\r\n"
+      end
+
+      def build_multipart_file_part(boundary, key, filename, content)
+        "--#{boundary}\r\n" \
+          "Content-Disposition: form-data; name=\"#{key}\"; filename=\"#{filename}\"\r\n" \
+          "Content-Type: application/octet-stream\r\n" \
+          "\r\n" \
+          "#{content}\r\n"
       end
       end
     end

data/lib/alipay/easysdk/kernel/factory.rb

@@ -1,6 +1,8 @@
 require_relative 'alipay_constants'
 require_relative 'config'
+require_relative 'cert_environment'
 require_relative 'easy_sdk_kernel'
+require_relative '../payment/app/client'
 require_relative '../payment/wap/client'
 require_relative '../payment/page/client'
 require_relative '../payment/common/client'
@@ -12,10 +14,13 @@ module Alipay
         class ConfigurationNotSetError < StandardError; end
 
         class << self
-          def set_options(options = nil)
+          def set_options(options)
+            raise ArgumentError, '配置参数不能为空' if options.nil?
+            return @instance if defined?(@instance) && @instance
+
             config = normalize_config(options)
             initialize_context(config)
-            @instance
+            @instance = self
           end
 
           alias setOptions set_options
@@ -26,14 +31,18 @@ module Alipay
             @config
           end
 
-          def payment
-            ensure_context_set!
-            @payment
-          end
+      def payment
+        ensure_context_set!
+        @payment
+      end
 
-          def wap
-            payment.wap
-          end
+      def app
+        payment.app
+      end
+
+      def wap
+        payment.wap
+      end
 
           def page
             payment.page
@@ -55,21 +64,30 @@ module Alipay
           private
 
           def normalize_config(options)
-            raise ArgumentError, '配置参数不能为空' if options.nil?
             return options if options.is_a?(Config)
             Config.new(options)
           end
 
           def initialize_context(config)
+            apply_cert_environment(config)
             @config = config
             @kernel = EasySDKKernel.new(config)
             @payment = Payment.new(@kernel)
-            @instance = self
           end
 
           def ensure_context_set!
             raise ConfigurationNotSetError, '请先调用Factory.set_options(config)设置SDK配置' unless @config
           end
+
+          def apply_cert_environment(config)
+            return if config.alipayCertPath.nil? || config.alipayCertPath.to_s.strip.empty?
+
+            cert_env = CertEnvironment.new
+            cert_env.setup(config.merchantCertPath, config.alipayCertPath, config.alipayRootCertPath)
+            config.merchantCertSN = cert_env.merchant_cert_sn
+            config.alipayRootCertSN = cert_env.root_cert_sn
+            config.alipayPublicKey ||= cert_env.cached_alipay_public_key
+          end
         end
 
         class Payment
@@ -77,6 +95,10 @@ module Alipay
             @kernel = kernel
           end
 
+          def app
+            @app ||= Alipay::EasySDK::Payment::App::Client.new(@kernel)
+          end
+
           def wap
             @wap ||= Alipay::EasySDK::Payment::Wap::Client.new(@kernel)
           end