ralipay 0.0.3 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 8106fe0016c5c10983d383d25986faaa9f95caa0
-  data.tar.gz: f0f4a072239c608e9d9cd4fee85b47ba250caf24
+  metadata.gz: ffa7224be52da431a62dbbd7fe48e6cc9e5f5da0
+  data.tar.gz: d2227107e9fb55aae21e5c0bf7872e4332c29384
 SHA512:
-  metadata.gz: fdb04223b1a5b7e4d962e982e5ca093c12b5260ae7527acd99e1f38cbddb68431e7af883bb800c895331fc7007646659b24af495f18426328a2a8e87c4ccab5d
-  data.tar.gz: c6495e7562763e3e8b72e74468e550caad2373e932c8356adc92b3e990ed69ae587f0466ca5fba7eb47431de7067cd63f5689fe7d1ee2bab16f7aca6e6bd99da
+  metadata.gz: 7773a0a08db868eb09b0cbcb39b50b5fe87f943f4e8430522ff34165c6a646d7ac793c6798ea52522c7f7dcaa3876640ba51834d7a177040b48eec96fd889d7e
+  data.tar.gz: 722d39bf8d156a24aa6a9fa612be63f129a40e879baf3605cada4797c76e84371660d66234497a157c97406374bb5ac519a4b75194cc9e780792ac01acd82250

data/README.md

@@ -1,6 +1,6 @@
 # Ralipay
 
-A ruby Gem for Alipay
+A ruby Gem for Alipay, contains web payment and mobile client payment
 
 ## Installation
 
@@ -16,15 +16,124 @@ Or install it yourself as:
 
     $ gem install ralipay
 
+## API
+
+    Ralipay::WapPayment.new
+
+    Ralipay::WapPayment.generate_pay_url
+
+    Ralipay::WapPayment.callback_verify?
+
+    Ralipay::WapPayment.callback_verify
+
+    Ralipay::WapPayment.notify_verify?
+
+    Ralipay::WapPayment.notify_verify
+
+    Ralipay::ClientPayment.notify_verify?
+
+    Ralipay::ClientPayment.notify_verify
+
+    Ralipay::ClientPayment.callback_verify?
+
+    Ralipay::Common::build_sign
+
+    Ralipay::Common::create_link_string
+
+    Ralipay::Common::rsa_sign
+
+    Ralipay::Common::md5_sign
+
+    Ralipay::Common::verify?
+
+    Ralipay::Common::para_filter
+
+    Ralipay::Common::decrypt
+
+
 ## Usage
 
-完成度30%
+### 准备
+
+- 申请你的支付宝商户服务
+
+- 取调用支付宝支付接口的账户信息
+
+- 并使用openssl工具生成好公钥与私钥(建议使用RSA加密方式)
+
+### 生成一个商品的WAP支付地址
+
+准备好参数:configs(hash symbol)
+
+    configs = {
+            :partner => '0000000000000',  #商户id partner_id
+            :seller_email => 'service@iiseeuu.com',  #商户email
+            :rsa_private_key_path => '/Users/ZhouYT/Desktop/rsa_private_key.pem',  #私钥绝对路径
+            :rsa_public_key_path  => '/Users/ZhouYT/Desktop/alipay_public_key.pem',  #公钥绝对路径
+            :subject => '测试商品',  #商品名称
+            :out_trade_no => '1222222233',  #外部交易号,不能重复
+            :total_fee => '0.01',  #交易价格
+            :notify_url => 'http://xx.xx.xx.xx/xx/xx',  #服务器异步回调通知接口地址
+            :merchant_url => 'http://xx.xx.xx.xx/xx/xx',  #商品展示地址
+            :call_back_url => 'http://xx.xx.xx.xx/xx/xx'  #支付成功同步回调跳转地址
+        }
+获取url
+
+    url = Ralipay::WapPayment.new(configs).generate_pay_url
+
+将当前页面redirect到该url上
+
+### wap支付同步回调页面callback_url(get方法)
+
+同样需要上面的configs(hash symbol),在new的时候只需要配置公钥和私钥就可以了
+
+准备好当前页面获取到的get请求获取到的所有参数与值,用hash symbol形式传入
+
+    Ralipay::WapPayment.new(configs).callback_verify?(gets)
+
+callback_verify? 方法只返回bool
+
+callback_verify 方法返回支付状态,并安全的返回回调参数hash,失败返回false
+
+返回的hash内容:
+
+    :trade_no
+    :out_trade_no
+
+### wap支付异步回调接口notify_url(post方法)
+
+同样需要上面的configs(hash symbol),在new的时候只需要配置公钥和私钥就可以了
+
+准备好当前页面获取到的post请求获取到的所有参数与值,用hash symbol形式传入
+
+    Ralipay::WapPayment.new(configs).notify_verify?(posts)
+
+异步回调验证,支付宝主动通知,前端POST xml方式获得参数,该方法只返回bool
+
+成功请自行向支付宝打印纯文本success
+
+如验签失败或未输出success支付宝会24小时根据策略重发总共7次,需考虑重复通知的情况
+
+notify_verify? 方法只返回bool
+
+notify_verify 方法返回支付状态,并安全的返回回调参数hash,失败返回false
+
+### 客户端sdk支付异步回调通知接口notify_url(post方法)
+
+同样需要上面的configs(hash symbol),在new的时候只需要配置公钥和私钥就可以了
+
+准备好当前页面获取到的post请求获取到的所有参数与值,用hash symbol形式传入
+
+    Ralipay::ClientPayment.new(configs).notify_verify?(posts)
+
+此方法与wap支付一致,内部处理有所不同
+
+### 客户端sdk支付同步验证callback_url(post方法)
+
+客户端callback回调之后POST请求服务器callback_url
 
+前端处理时在验签通过就给客户端返回2，不通过就返回1
 
-## Contributing
+    Ralipay::ClientPayment.new(configs).callback_verify?(posts)
 
-1. Fork it
-2. Create your feature branch (`git checkout -b my-new-feature`)
-3. Commit your changes (`git commit -am 'Add some feature'`)
-4. Push to the branch (`git push origin my-new-feature`)
-5. Create new Pull Request
+该方法可以不使用

data/lib/ralipay/version.rb

@@ -1,3 +1,3 @@
 module Ralipay
-  VERSION = "0.0.3"
+  VERSION = "1.0.0"
 end

data/lib/ralipay.rb

@@ -7,13 +7,12 @@ module Ralipay
   require 'json'
   require 'date'
   require 'nokogiri'
+  require 'cgi'
 
   include Ralipay::Common
 
-  class Payment
-
-    #传入参数,必须初始化
-    $global_configs = {
+  #初始化参数
+  $global_configs = {
       :secure_type   => 'RSA',
       :partner       => '',
       :seller_email  => '',
@@ -26,17 +25,20 @@ module Ralipay
       :out_user      => '',
       :rsa_private_key_path => '',
       :rsa_public_key_path  => ''
-    }
-
-    #固定参数,无需修改
-    $service1            = 'alipay.wap.trade.create.direct'
-    $service2            = 'alipay.wap.auth.authAndExecute'
-    $format              = 'xml'
-    $sec_id              = '0001'
-    $input_charset       = 'utf-8'
-    $input_charset_gbk   = 'GBK'
-    $service_pay_channel = 'mobile.merchant.paychannel'
-    $v                   = '2.0'
+  }
+
+  #固定参数,无需修改
+  $service1            = 'alipay.wap.trade.create.direct'
+  $service2            = 'alipay.wap.auth.authAndExecute'
+  $format              = 'xml'
+  $sec_id              = '0001'
+  $input_charset       = 'utf-8'
+  $input_charset_gbk   = 'GBK'
+  $service_pay_channel = 'mobile.merchant.paychannel'
+  $v                   = '2.0'
+
+  #wap支付类
+  class WapPayment
 
     def initialize(configs)
       #@todo 入参合法性验证
@@ -44,7 +46,7 @@ module Ralipay
     end
 
     #生成wap支付地址
-    def generate_wap_pay_url
+    def generate_pay_url
       params = {
           :_input_charset => $input_charset_gbk,
           :sign_type      => $sec_id,
@@ -170,4 +172,73 @@ module Ralipay
 
   end
 
+  #手机SDK客户端支付类,与wap流程不同,且只允许RSA验签
+  class ClientPayment
+
+    def initialize(configs)
+      #@todo 入参合法性验证
+      $global_configs = $global_configs.merge configs
+    end
+
+    #异步回调验证,支付宝主动通知,前端POST xml方式获得参数,该方法只返回bool
+    #成功请自行向支付宝打印纯文本success
+    #如验签失败或未输出success支付宝会24小时根据策略重发总共7次,需考虑重复通知的情况
+    def notify_verify? posts
+      notify_data = 'notify_data=' + posts[:notify_data].to_s
+      sign        = posts[:sign]
+      #验签名
+      verify = Ralipay::Common::verify?(notify_data, sign)
+
+      if verify
+        #解密并解析返回参数的xml
+        xml    = posts[:notify_data]
+        doc    = Nokogiri::XML xml
+        status = doc.xpath('/notify/trade_status').text
+        #获得可信的交易状态
+        status == 'TRADE_FINISHED' ? true : false
+      else
+        false
+      end
+    end
+
+    #异步回调验证,支付宝主动通知,前端POST xml方式获得参数,该方法返回支付状态,并安全的返回回调参数hash,失败返回false
+    #成功请自行向支付宝打印纯文本success
+    #如验签失败或未输出success支付宝会24小时根据策略重发总共7次,需考虑重复通知的情况
+    def notify_verify posts
+      notify_data = 'notify_data=' + posts[:notify_data].to_s
+      sign        = posts[:sign]
+      #验签名
+      verify = Ralipay::Common::verify?(notify_data, sign)
+
+      if verify
+        #解密并解析返回参数的xml
+        xml    = posts[:notify_data]
+        doc    = Nokogiri::XML xml
+        status = doc.xpath('/notify/trade_status').text
+        #获得可信的交易状态
+        if status == 'TRADE_FINISHED'
+          {
+              :out_trade_no => doc.xpath('/notify/out_trade_no').text,
+              :subject      => doc.xpath('/notify/subject').text,
+              :price        => doc.xpath('/notify/price').text,
+              :trade_no     => doc.xpath('/notify/trade_no').text
+          }
+        else
+          false
+        end
+      else
+        false
+      end
+    end
+
+    #客户端callback回调之后POST请求服务器callback_url,传入hash symbol,该方法只返回bool
+    #前端在验签通过就给客户端返回2，不通过就返回1
+    def callback_verify? posts
+      sign    = CGI::unescape posts[:sign]
+      content = CGI::unescape posts[:content]
+      Ralipay::Common::verify?(content, sign)
+    end
+
+  end
+
 end

data/test/test_ralipay.rb

@@ -17,7 +17,7 @@ class TestRalipay < Test::Unit::TestCase
         :call_back_url => 'http://www.iiseeuu.com'
     }
     assert_equal "需要手动访问url进行测试",
-                 Ralipay::Payment.new(configs).generate_wap_pay_url
+                 Ralipay::WapPayment.new(configs).generate_pay_url
   end
 
   def test_callback_verify
@@ -43,7 +43,7 @@ class TestRalipay < Test::Unit::TestCase
         :sign_type => '0001'
     }
     assert_equal true,
-                 Ralipay::Payment.new(configs).callback_verify?(gets)
+                 Ralipay::WapPayment.new(configs).callback_verify?(gets)
   end
 
   def test_notify_verify
@@ -67,7 +67,7 @@ class TestRalipay < Test::Unit::TestCase
         :notify_data => 'Ych9Cg/zaLHsqaBePwoFtxAE7vX0ZvslWCLFTP1AdsxQgvrEcwflAFdbhIHgqsy8AZdRGp7rNeP1Bpn9v+feNlHD96RQit4p1/JHTAOfdoNmQsRaDvBNH9xUlCANXC4zTFDxCZEJN79ppSAzhOu1iMAdUOzim+ZAacxpkMfM4c+YSkpXrEK7kt3Lw4FpkJwwkRAUlYNtrlva94Qo6RZDmo4UpDlUyS1GkqIOihnwxzE4rDO84txzVWtdGDD+Il5ev7nVwnbcsaJzbhl7jgkg8+KzcoIibrn8QJy/xsSckwXZ2pq9Q2d+ufOd/zqpeUvTaD9nNbaH0UYZXDzKPnS91au6zk/2Nqe1d+TsNBeU7muQTM719y7btzfq6tRjs2eNdOfinIYK/MC0lypYtakHrIxpxqyKe1UlpyIVwUauKBkzmJP03x4FJOC7jsbVxI7N2Um/7qlAYCIzLog+SvjW3RX7dhjXAG72qJ93yrTySMJE4yvHEhSFfc2EgjepMzVlCNLwlENrvzkTiqs6rdrKmReKLr2D4QETC5qPL+v3S1iEdlPN4z0KKxp1RWzdwNfLtOceas+lx8oNM2AiQ4O0Y8+YDI/NX7xjckPzwPsEfNWYnwfLYb3MkbmIfhRVozQtsVI4VfxLX35bSQLVtKPdAM4foUIZFh0+HGM+qiSNtZQ2BWjmOUFvIdNyrxMzrRF2+BnuoP+lCkOvQdOnWNoBFpD8aUQrD48AJHQTeyf63bSeJ5Vdif/LPpeJjL+FkP/k+h6mcvigIo1ZcOoF9S2Gg20EgXZWggqR7RLnkroCaNbn/86gZsDQvtwn855n3PRQxosw8a/0F5uFIt/oD5zI7TDFv+p3q9SO3+GYaOwd6OHK3hS11kx2EpzYWw9PaFoANsER9r9buKvQDfcJDkxeN79qmP2zuznVq9OM5X9wDFy2WiFfyYl/swuvZN5e9Q2c0MXj9aeA2H464Am+iFOv1lBWGOlxyVsTQuFjRzRg4FIOp8cv0qOtI/UQPWGbGAy4qys7+sJN/wkboLpdWKLhwgPzto9TM0jN5GZMeA35+2wGcuPAe/SNqhvWM9r8xeCniuSDjesHWWN5bkiYzB4cb0n+E72Yh5WmwJw87ySuXAQWgONxnzgjX0LAGiinoBoufBqmpi/f8vAV3sJFEzkGZxFLSO1Us1ldSi16IqnPTdNtaQAe0N+QYnALM10rmsuGp4/jJatFWFMnmi06AMLcC31who0SD/xItGl6riSkX0yDqWQJzCvZUrrZJoqXJ7XBZoCQscL3Ug2RCKrGba/Ekc10EQINiX99XzYUPVK8xKxO4WW/7T00rZ8B1YjnUaBdWKGdmWmv0itnLx6rK8NWBw=='
     }
     assert_equal true,
-                 Ralipay::Payment.new(configs).notify_verify?(posts)
+                 Ralipay::WapPayment.new(configs).notify_verify?(posts)
   end
 
   def test_para_filter

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ralipay
 version: !ruby/object:Gem::Version
-  version: 0.0.3
+  version: 1.0.0
 platform: ruby
 authors:
 - RaymondChou