reapal 0.2.2 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: dec4bffac163868bb8653e0a4a8c581805d972ee
-  data.tar.gz: c78c514b8ffaa353fb25cc192f540332863a74e3
+  metadata.gz: 234567f57cee288220964fc4bf120ae802400e36
+  data.tar.gz: 6362601c991f78ca39ee6d3ab0f80048fe1de8f8
 SHA512:
-  metadata.gz: 95d1285c4361aa039f080c5a743295c21563c127eef94411ed2702f46c564ac94025b70388bcddbbd6e4b80c24c4fddb6f603aa475a985d8cfffccf1255a5051
-  data.tar.gz: f294e4e9588ed898361effef09cfea57b63a54bbe8c4b2b67a58e9872895763d18ff68d7e8248bf3820403c758b6d895a604ddf57721506b7e41ce55612b4567
+  metadata.gz: 75214217a309e67040291e008ed14f0dc5770fcc308b7a14b16d4913c2c3bf48fc65c3467d67dc955bbefb91051cbc4555536f5a29799fdf14bbc148770d7d62
+  data.tar.gz: 22dc9b134b5ef4a0fab39886be7b84cedc57ce5ef4987072caadc390b99a5b004accc714e1d8695048c521953781129ddb26404c449ee4016a2a2c7306095c4d

data/README.md

@@ -76,7 +76,7 @@ After checking out the repo, run `bin/setup` to install dependencies. Then, run
 
 To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
 
-** 建议 **
+**建议**
 1. 使用 [fasterer](https://github.com/DamirSvrtan/fasterer) 来优化写的代码，怎么修改可以查看[这里](https://github.com/JuanitoFatas/fast-ruby)
 2. 使用 [rubycritic](https://github.com/whitesmith/rubycritic) 来检测代码质量
 

data/Rakefile

@@ -5,12 +5,8 @@ RSpec::Core::RakeTask.new(:spec)
 
 task :default => :spec
 
-task :build do
-  puts `gem build reapal.gemspec`
-end
-
 task :push do
-  puts `gem push reapal-#{Reapal::VERSION}.gem`
+  puts `gem push pkg/reapal-#{Reapal::VERSION}.gem`
 end
 
 task :publish => [:build, :push]

data/lib/reapal.rb

@@ -17,7 +17,14 @@ require "reapal/sign/md5"
 require "reapal/encrypt/rsa"
 require "reapal/encrypt/aes"
 require "reapal/http/communicate"
+require "reapal/http/decode"
 require "reapal/http/response"
+require "reapal/http/error_code/common"
+require "reapal/http/error_code/user"
+require "reapal/http/error_code/money"
+require "reapal/http/error_code/tender"
+require "reapal/http/error_code/order"
+
 # 自动加载所有 api
 Dir["#{File.dirname(__FILE__)}/reapal/api/**/*.rb"].each { |file| require file }
 # 自动加载所有 form

data/lib/reapal/api/api_helper.rb

@@ -0,0 +1,51 @@
+# coding: utf-8
+module Reapal
+  module Api
+    module CommunicateResultHelper
+
+      # 操作类的 api，统一返回处理
+      #
+      # @param request_type [Symbole] 操作类（:operate）/查询类(:query)
+      # @param service [ String ] 富民的服务
+      # @param params [ Hash ] 参数
+      # @param post_path [ String ] post url
+      # @param fail_codes [ Array ] 错误返回码
+      # @param success_codes [ String ] 【业务】【明确的】正确返回码（而不是申请成功这类）
+      #
+      # @return [ Hash ] 结果集(见通用返回)
+      #
+      def operate_post(request_type, service, params, post_path, fail_codes, success_codes, version=nil)
+        response = Http.post(service, params, @config, post_path, version)
+
+        res = Reapal::Utils.api_result(params, response)
+
+        if :operate == request_type
+          # 向服务器发送操作，超时类的都应该当 pending 处理
+          return res if response.http_pending?
+        elsif :query == request_type
+          # 查询类 api，http 没成功都返回 pending
+          return res unless response.http_success?
+        else
+          raise "未知的请求类型，请选择设置：操作类（:operate）/查询类(:query)"
+        end
+
+        # 确定的错误
+        if fail_codes.include?(response.data[:errorCode])
+          res[:result] = "F"
+          return res
+        end
+
+        # 其余 api 错误不知道
+        return res unless response.data[:errorCode].nil?
+
+        # 确定的成功返回码
+        if success_codes.include?(response.data[:resultCode])
+          res[:result] = "S"
+        end
+
+        res
+      end
+
+    end # CommunicateResultHelper
+  end
+end

data/lib/reapal/api/money/deposit_apply_api.rb

@@ -0,0 +1,73 @@
+# coding: utf-8
+
+module Reapal
+  module Api
+    module Money
+      module DepositApplyApi
+
+        # 2.2 快捷充值签约（API）
+        #
+        # @param flow_id [ String ] 订单号
+        # @param contracts [ String ] 用户协议号
+        # @param bank_card [ String ] 银行卡卡号
+        # @param true_name [ String ] 持卡人姓名
+        # @param identity_id [ String ] 身份证号
+        # @param phone [ String ] 用户手机（注意是银行卡预留手机号）
+        # @param amount [ BigDecimal ] 交易金额
+        # @param charge [ BigDecimal ] 手续费
+        # @param terminal_info [ String ] 终端信息（手机IMEI地址、MAC地址、UUID）
+        # @param member_ip [ String ] 用户IP
+        # @param notify_url [ String ] 通知URL
+        # @param cert_type [ String ] 证件类型 （暂时只支持身份证：01）
+        # @param currency [ String ] 交易币种（默认人民币（仅支持人民币cny））
+        # @param bus_way [ String ] 00：PC端；01：手机端；02：Pad端；03：其它
+        # @param remark [ String ] 备注
+        #
+        # @return [ Hash ] 结果集
+        #   * :result [String] 业务结果：'S/F/P'
+        #   * :request_params [Hash] 请求参数
+        #   * :response [Object] 请求返回对象
+        #   * :error_code [String] 错误代号
+        #   * :error_msg [String] 错误信息
+        #   * :data: 具体业务返回信息
+        #     * :orderNO [String] 充值订单号
+        #     * :bindId [String] 绑卡ID
+        #     * :certificate [String] 招商银行标识（有此标识表示充值卡为招商银行，返回值为0，
+        #                                         则表示需要调用招商卡密接口，若返回值为1，
+        #                                         直接调用充值确认接口。若此字段不存在则表示非招行卡，可直接调用充值确认接口完成扣款）
+        #     * :resultCode [String] 结果代码
+        #     * :resultMsg [String] 结果描述
+        #
+        def deposit_apply_api(flow_id, contracts, bank_card, true_name, identity_id,
+                              phone, amount, charge, terminal_info, member_ip,
+                              notify_url, cert_type = '01', currency = 'cny', bus_way = '01', remark = '')
+
+          service = 'reapal.trust.depositApplyAPI'
+          post_path = '/reagw/service/depwit.htm'
+
+          params = {
+            orderNo: flow_id,
+            contracts: contracts,
+            bankCard: bank_card,
+            userName: true_name,
+            certType: cert_type,
+            userIdentity: identity_id,
+            userMobile: phone,
+            currency: currency,
+            amount: amount,
+            charge: charge,
+            busway: bus_way,
+            terminalInfo: terminal_info,
+            memberIp: member_ip,
+            notifyUrl: notify_url,
+            remark: remark,
+            applyTime: Time.now.strftime('%Y-%m-%d %H:%M:%S'),
+          }
+
+          operate_post(:operate, service, params, post_path, Http::ErrorCode.deposit_apply_api, ['0000'], '2.0')
+        end
+
+      end # module
+    end
+  end
+end

data/lib/reapal/api/money/deposit_confirm_api.rb

@@ -0,0 +1,49 @@
+# coding: utf-8
+
+module Reapal
+ module Api
+   module Money
+     module DepositConfirmApi
+
+       # 2.3 快捷充值确认（API）
+       #
+       # @param flow_id [ String ] 商户订单号（非自动生成，与充值签约订单号一致）
+       # @param contracts [ String ] 用户协议号
+       # @param check_code [ String ] 短信验证码
+       # @param terminal_info [ String ] 终端信息（手机IMEI地址、MAC地址、UUID）
+       # @param member_ip [ String ] 用户IP
+       # @param busway [ String ] 设备通道 00：PC端；01：手机端；02：Pad端；03：其它
+       # @param remark [ String ] 业务备注信息
+       #
+       # @return [ Hash ] 结果集
+       #   * :result [String] "S"/"F"/"P"
+       #   * :request_params [Hash] 请求参数
+       #   * :response [Object] 请求返回对象
+       #   * :error_code [String] 错误代号
+       #   * :error_msg [String] 错误信息
+       #   * :data: 具体业务返回信息
+       #       * :orderNo [String]  订单号
+       #       * :resultCode [String] 结果代码 0000：充值成功
+       #       * :resultMsg [String] 结果描述
+       #
+       def deposit_confirm_api(flow_id, contracts, check_code, terminal_info, member_ip, busway = '01', remark = '')
+         service = 'reapal.trust.depositConfirmAPI'
+         post_path = '/reagw/service/depwit.htm'
+
+         params = {
+           orderNo: flow_id,
+           contracts: contracts,
+           checkCode: check_code,
+           busway: busway,
+           terminalInfo: terminal_info,
+           memberIp: member_ip,
+           applyTime: Time.now.strftime('%Y-%m-%d %H:%M:%S'),
+         }
+
+         operate_post(:operate, service, params, post_path, Http::ErrorCode.deposit_confirm_api, ['0000'])
+       end
+
+     end # module
+   end
+  end
+end

data/lib/reapal/api/money/deposit_query.rb

@@ -0,0 +1,36 @@
+# coding: utf-8
+
+module Reapal
+  module Api
+    module Money
+      module DepositQuery
+
+        # 2.6 充值查询（API）
+        #
+        # @param deposit_flow_id [ String ] 充值订单号
+        #
+        # @return [ Hash ] 结果集
+        #   * :result [String] "S"/"F"/"P"
+        #   * :error_msg [String] 错误提示
+        #   * :data [Hash] 成功数据
+        #       * :orderNo [String]  充值订单号
+        #       * :amount [BigDecimal] 交易金额
+        #       * :charge [BigDecimal] 手续费
+        #       * :resultCode [String] 结果代码
+        #
+        def deposit_query(deposit_flow_id)
+          service = 'reapal.trust.depositQuery'
+          post_path = '/reagw/service/depwit.htm'
+
+          params = {
+            orderNo: deposit_flow_id,
+            queryTime: Time.now.strftime('%Y-%m-%d %H:%M:%S'),
+          }
+
+          operate_post(:query, service, params, post_path, Http::ErrorCode.deposit_query, ['0000'])
+        end
+
+      end # module
+    end
+  end
+end

data/lib/reapal/api/money/deposit_sms_api.rb

@@ -0,0 +1,48 @@
+# coding: utf-8
+
+module Reapal
+  module Api
+    module Money
+      module DepositSmsApi
+
+        # 2.4 快捷充值重发短信（API）
+        #
+        # @param flow_id [ String ] 订单号（非自动生成，与充值签约订单号保持一致）
+        # @param contracts [ String ] 用户协议号
+        # @param busway [ String ] 设备通道 00：PC端；01：手机端；02：Pad端；03：其它
+        # @param terminal_info [ String ] 终端信息（手机IMEI地址、MAC地址、UUID）
+        # @param member_ip [ String ] 用户IP
+        # @param remark [ String ] 业务备注信息
+        #
+        # @return [ Hash ] 结果集
+        #   * :result [String] 业务结果：'S/F/P'
+        #   * :request_params [Hash] 请求参数
+        #   * :response [Object] 请求返回对象
+        #   * :error_code [String] 错误代号
+        #   * :error_msg [String] 错误信息
+        #   * :data: 具体业务返回信息
+        #       * :orderNo [String]  订单号
+        #       * :resultCode [String] 结果代码 0000：发送成功
+        #       * :resultMsg [String] 结果描述
+        #
+        def deposit_sms_api(flow_id, contracts, terminal_info, member_ip, busway = '01', remark = "")
+          service = 'reapal.trust.depositSmsAPI'
+          post_path = '/reagw/service/depwit.htm'
+
+          params = {
+            orderNo: flow_id,
+            contracts: contracts,
+            busway: busway,
+            terminalInfo: terminal_info,
+            memberIp: member_ip,
+            remark: remark,
+            applyTime: Time.now.strftime('%Y-%m-%d %H:%M:%S'),
+          }
+
+          operate_post(:operate, service, params, post_path, Http::ErrorCode.deposit_sms_api, ['0000'])
+        end
+
+      end # module
+    end
+  end
+end

data/lib/reapal/api/money/sub_account.rb

@@ -0,0 +1,53 @@
+# coding: utf-8
+
+module Reapal
+  module Api
+    module Money
+      module SubAccount
+
+        # 2.11 企业分账（API）
+        #
+        # @param flow_id [ String ] 完成订单号
+        # @param sub_type [ String ] 分账类型 1：代还款。2：分账。3：其它
+        # @param sub_details [ Array ] 分账明细
+        #          * serial_no [String] 分账流水号
+        #          * payee_contracts [String] 收款方协议号
+        #          * amount [BigDecimal] 金额
+        #          * mark [String] 备注
+        # @param remark [ String ] 业务备注信息
+        #
+        # @return [ Hash ] 结果集
+        #   * :result [String] 业务结果：'S/F/P'
+        #   * :request_params [Hash] 请求参数
+        #   * :response [Object] 请求返回对象
+        #   * :error_code [String] 错误代号
+        #   * :error_msg [String] 错误信息
+        #   * :data: 具体业务返回信息
+        #      * :flow_id [String] 完成订单号
+        #      * :result_code [String] 结果代码 0000：分账成功 0001:失败
+        #
+        def sub_account(flow_id, sub_type, sub_details, remark ='')
+          service = 'reapal.trust.subAccount'
+          post_path = '/reagw/service/depwit.htm'
+
+          params = {
+            orderNo: flow_id,
+            subType: sub_type,
+            subDetails: sub_details,
+            remark: remark,
+            applyTime: Time.now.strftime('%Y-%m-%d %H:%M:%S'),
+          }
+
+          res = operate_post(:operate, service, params, post_path, Http::ErrorCode.sub_account, ['0000'])
+
+          if 'S' == res[:result] && '0001' == res[:data][:resultCode]
+            res[:result] = 'F'
+          end
+          
+          res
+        end
+
+      end # module
+    end
+  end
+end

data/lib/reapal/api/money/sub_account_query.rb

@@ -0,0 +1,45 @@
+# coding: utf-8
+
+module Reapal
+  module Api
+    module Money
+      module SubAccountQuery
+
+        # 2.8 企业分账查询（API）
+        #
+        # @param sub_account_flow_id [ String ] 分账订单号
+        # @param serial_no [ String ] 分账流水号（传空串表示该订单批量查询）
+        #
+        # @return [ Hash ] 结果集
+        #   * :result [String] 业务结果：'S/F/P'
+        #   * :request_params [Hash] 请求参数
+        #   * :response [Object] 请求返回对象
+        #   * :error_code [String] 错误代号
+        #   * :error_msg [String] 错误信息
+        #   * :data: 具体业务返回信息
+        #       * :orderNO [String] 分账订单号
+        #       * :subDetails [String]  分账明细
+        #           * serialNo [String] 分账流水号
+        #           * payeeContracts [String] 收款方协议号
+        #           * amount [BigDecimal] 金额
+        #           * remark [String] 备注
+        #           * resultCode [String] 结果代码
+        #       * :resultCode [String] 结果代码 0000：分账成功；0001 : 分账失败；0002：处理中
+        #
+        def sub_account_query(sub_account_flow_id, serial_no='')
+          service = 'reapal.trust.subAccountQuery'
+          post_path = '/reagw/service/depwit.htm'
+
+          params = {
+            orderNo: sub_account_flow_id,
+            serialNo: serial_no,
+            queryTime: Time.now.strftime('%Y-%m-%d %H:%M:%S'),
+          }
+
+          operate_post(:query, service, params, post_path, Http::ErrorCode.sub_account_query, ['0000'])
+        end
+
+      end # module
+    end
+  end
+end

data/lib/reapal/api/money/withdraw_query.rb

@@ -0,0 +1,47 @@
+# coding: utf-8
+
+module Reapal
+  module Api
+    module Money
+      module WithdrawQuery
+
+        # 2.8 提现查询（API）
+        #
+        # @param withdraw_flow_id [ String ] 提现订单号
+        #
+        # @return [ Hash ] 结果集
+        #   * :result [String] 业务结果：'S/F/P'
+        #   * :request_params [Hash] 请求参数
+        #   * :response [Object] 请求返回对象
+        #   * :error_code [String] 错误代号
+        #   * :error_msg [String] 错误信息
+        #   * :data: 具体业务返回信息
+        #       * :orderNo [String]  提现订单号
+        #       * :amount [BigDecimal] 交易金额
+        #       * :userName [String] 用户姓名
+        #       * :bankName [String] 提现银行
+        #       * :bankCard [String] 提现银行卡后四位
+        #       * :resultCode [String] 结果代码 0000：申请成功（待出款）0002：提现成功 0003：提现失败
+        #
+        def withdraw_query(withdraw_flow_id)
+          service = 'reapal.trust.withdrawQuery'
+          post_path = '/reagw/service/depwit.htm'
+
+          params = {
+            orderNo: withdraw_flow_id,
+            queryTime: Time.now.strftime('%Y-%m-%d %H:%M:%S'),
+          }
+
+          res = operate_post(:query, service, params, post_path, Http::ErrorCode.withdraw_query, ['0002'])
+
+          if 'S' == res[:result] && '0003' == res[:data][:resultCode]
+            res[:result] = 'F'
+          end
+
+          res
+        end
+
+      end # module
+    end
+  end
+end