alipay_global 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 277cdcc60f0660b3047710c99eee24fea1b81ca4
+  data.tar.gz: d7e43f4ffa4e124f2c4c4dbc7c1819be4133506d
+SHA512:
+  metadata.gz: bfdb330a01eb4220f22242d2e6d6842cad17afe8a0298e2777f0f7ad00a7d68cc85109773117a268132b740788d62910df953d52a5f660126f8ba1351c67bab3
+  data.tar.gz: 6e6d3adfd70c7888b5289c15237199ca55bb21d6e58979ed9329158f2a1bf1badf42dbc2c0d2f4dd219b99ff5103561c6c99933325f73602b91d01ba18681c06

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Gem dependencies in alipay_global.gemspec
+gemspec

data/LICENSE

@@ -0,0 +1,22 @@
+The MIT License (MIT)
+
+Copyright (c) 2015 Melvrick 
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

data/README.md

@@ -0,0 +1,250 @@
+# alipay-global
+Unofficial gem for linking up to global.alipay for remote payment
+
+Development of this gem is largely influenced by the [unofficial alipay gem](https://github.com/chloerei/alipay). Code structure has been replicated from here in some areas.
+
+You can find the docs for global.alipay's Cross Border Payment service [here](http://global.alipay.com/product/mobilepayments.htm)
+
+## Configuration
+
+If you're using MD5, the api_secret_key needs to be initialized. If RSA is used, the private_key_location needs to be initialized. DSA is currently not supported.
+
+```ruby
+AlipayGlobal.api_partner_id = 'YOUR_PID'
+AlipayGlobal.api_secret_key = 'YOUR_KEY'
+
+#AlipayGlobal.private_key_location = 'YOUR PRIVATE KEY LOCATION' #Your .pem file location
+
+#AlipayGlobal.sign_type = 'MD5' # Available values: MD5, RSA. Default is MD5
+#AlipayGlobal.debug_mode = true # Enable parameter check. Default is true.
+```
+
+## Warning
+
+### Still in testing phase. Gem is not yet ready for production use and is prone to failures/ bugs. Use at your own peril. Full functionality hasn't been achieved yet too
+
+## Usage
+
+### Service
+
+#### Service::Trade
+
+```ruby
+create
+```
+
+#### Definition
+
+```ruby
+AlipayGlobal::Service::Trade.create({ARGUMENTS})
+```
+
+#### Issues (awaiting resolution)
+
+1. create_forex_trade
+  1. rmb_fee issues with MD5 Signature (awaiting Alipay tech response)
+  2. RSA integration: User needs to work with Alipay team to exchange RSA public keys to properly test the content
+2. testing environment
+  1. Alipay mobile site for testing is down. works in production.
+
+#### Example
+
+```ruby
+AlipayGlobal::Service::Trade.create(
+  out_trade_no: '20150401000-0001',
+  subject: 'Subject',
+  currency: 'USD',
+  total_fee: '10.00',
+  notify_url: 'https://example.com/orders/20150401000-0001/notify'
+)
+# => 'https://mapi.alipay.com/gateway.do?service=create_forex_trade...' #for production
+```
+
+#### ARGUMENTS
+
+| Key | Requirement | Data Type | Description |
+| --- | ----------- | --------- | ----------- |
+| mobile | optional **(unique to this gem)** | boolean | true/false boolean value. Tells the gem whether you want to direct the user to Alipay's mobile friendly site | 
+| out_trade_no | required | string | Order number in your application. (Unique inside the partner system) |
+| subject | required | string | The name of the goods. Cannot contain special symbols |
+| currency | required | string | The settlement currency merchant named in contract. Refer to abbreviation of currencies |
+| total_fee | required * | float | A floating number ranging 0.01~1000000.00 If use the rmb_fee, don’t use the total_fee |
+| notify_url | required | string | The URL for receiving notifications after the payment process |
+| rmb_fee | optional | float | 0.01~1000000.00 Use this parameter to replace total_fee if partner wish to price their product in RMB. If use the total_fee, don’t use the rmb_fee. |
+| return_url | optional | string | After the payment transaction is done, the result is returned via the URL (only suitable for interfaces with directly returned results). |
+| body | optional | string | A detailed description of the goods. Cannot contain special symbols |
+| order_gmt_create | optional | string | YYYY-MM-DD HH:MM:SS please use China local time in order to sync with Alipay sustem, this parameter can only be used with order_valid_time together in order to control the valid time from redirect to login |
+| order_valid_time | optional | string | Maximum is 21600,unit is second,this parameter can only be used with order_gmt_create together in order to control the valid time from redirection to login |
+| timeout_rule | optional | string | Options: 5m 10m 15m 30m 1h 2h 3h 5h 10h 12h. default is 12h. this parameter control the valid time from login to completion, please contact Alipay technical service if you want to enable this param |
+| auth_token | optional | string | The secure token from accessing express login API Mandatory for express login |
+| supplier | optional | string | seller name shown in the cashier |
+| seller_id | optional* | string | For PSG only The unique ID for PSG to identify a sub-merchant. |
+| seller_name | optional* | string | For PSG only. The name of sub-merchant who initiate the request. |
+| seller_industry | optional* | string | For PSG only The industry type of sub-merchant who initiate the request. |
+
+\* Normal Mechant: optional. FOR PSG: compulsory
+
+\*\*\* Attention1:In the case a merchant wish to price their products in RMB, the merchant shall not change the value of the currency parameter, instead he shall just replace the total_fee with rmb_fee, and then his trade will appears in RMB in front of user.
+
+\*\*\* Attention2:The request parameters can only be accepted by the Alipay system if they are signed according to the signature mechanism specified in this document.The parameter “timeout_rule”, the default value is 12h. If you want to use this parameter to change timing, you need to contact Alipay technical. Otherwise you will have an error.
+
+
+#### Service::Exchange
+
+```ruby
+current_rates
+```
+
+#### Definition
+
+```ruby
+AlipayGlobal::Service::Exchange.current_rates()
+```
+
+#### Example
+
+```ruby
+AlipayGlobal::Service::Exchange.current_rates()
+
+# Results: hash with following content
+# => {"AUD"=>{:time=>#<DateTime: 2012-03-30T11:25:37+00:00 ((2456017j,41137s,0n),+0s,2299161j)>, :rate=>6.4485}, "CAD"=>{:time=>#<DateTime: 2012-03-30T11:25:37+00:00 ((2456017j,41137s,0n),+0s,2299161j)>, :rate=>6.6682}, "CHF"=>{:time=>#<DateTime: 2012-04-24T11:25:37+00:00 ((2456042j,41137s,0n),+0s,2299161j)>, :rate=>6.829}, "DKK"=>{:time=>#<DateTime: 2012-04-24T11:25:37+00:00 ((2456042j,41137s,0n),+0s,2299161j)>, :rate=>2.0}, "EUR"=>{:time=>#<DateTime: 2012-04-24T11:25:37+00:00 ((2456042j,41137s,0n),+0s,2299161j)>, :rate=>8.3364}, "GBP"=>{:time=>#<DateTime: 2013-07-01T11:06:35+00:00 ((2456475j,39995s,0n),+0s,2299161j)>, :rate=>10.6744}, "HKD"=>{:time=>#<DateTime: 2012-02-27T12:55:00+00:00 ((2455985j,46500s,0n),+0s,2299161j)>, :rate=>0.8145}, "JPY"=>{:time=>#<DateTime: 2012-12-24T17:43:59+00:00 ((2456286j,63839s,0n),+0s,2299161j)>, :rate=>0.05638}, "KRW"=>{:time=>#<DateTime: 2012-10-18T14:07:10+00:00 ((2456219j,50830s,0n),+0s,2299161j)>, :rate=>0.001111}, "SEK"=>{:time=>#<DateTime: 2012-02-27T12:55:00+00:00 ((2455985j,46500s,0n),+0s,2299161j)>, :rate=>0.9375}, "SGD"=>{:time=>#<DateTime: 2012-02-27T12:55:00+00:00 ((2455985j,46500s,0n),+0s,2299161j)>, :rate=>4.938}, "USD"=>{:time=>#<DateTime: 2013-11-22T11:25:37+00:00 ((2456619j,41137s,0n),+0s,2299161j)>, :rate=>6.5487}}
+```
+
+#### Results
+
+Hash contains objects representing each currency. Each object is represented by it's named currency code.
+
+| Attribute | Data Type | Description |
+| --------- | --------- | ----------- |
+| time | DateTime | When Alipay retrieved the date and time of this currency rate |
+| rate | float | Rate for 1 FOREX Unit : Units of RMB/CNY  |
+
+
+#### Service::Notification
+
+It is necessary for the partner system to verify the integrity and correctness of Alipay’snotification. Intheinterestofsystem’shealthiness,itisstrongly recommended that the partner system apply such verification mechanism.
+
+In order to guarantee the interface will be used legally, the partner system can only verify the notifications within the last 1 minute (this configuration is subject to change, and such change will not be notified).
+
+```ruby
+check
+```
+
+#### Definition
+
+```ruby
+AlipayGlobal::Service::Notification.check({
+  notify_id: 'your_notification_id_received'
+})
+```
+
+#### Example
+
+```ruby
+AlipayGlobal::Service::Notification.check({
+  notify_id: 'your_notification_id_received'
+})
+
+# Results: Alipay will respond with whether this notification is valid or not?
+# => "false"
+```
+
+#### Parameters
+
+| Key | Requirement | Description |
+| --- | ----------- | ----------- |
+| notify_id | required | The ID of Alipay system’s notification. |
+
+\* Provided: provisioned by setting these environment variables from the start
+
+#### Results
+
+Notification verification output result list:
+
+| Result | Description |
+| ------ | ----------- |
+| invalid | The input parameter is invalid. |
+| true | Authentication passed. |
+| false | Authentication failed. |
+
+#### Service::Reconciliation
+
+After certain period of time, the oversea merchant partner needs to verify the past transaction details in order to make sure the correctness and integrity of transaction records. This can be performed by using the reconciliation file downloading interface. The starting and end dates should be provided within a 10-day interval. Same-day transaction details cannot be accessed by this interface.
+
+```ruby
+check
+```
+
+#### Definition
+
+```ruby
+AlipayGlobal::Service::Reconciliation.request({
+  'start_date'=> '20120202',
+  'end_date'=> '20120205'
+})
+```
+
+#### Parameters
+
+| Key | Requirement | Description |
+| --- | ----------- | ----------- |
+| start_date | required | The start date of the reconciliation period, formatted as YYYYMMDD |
+| end_date | required | The end date of the reconciliation period, formatted as YYYYMMDD |
+
+#### Example
+
+```ruby
+AlipayGlobal::Service::Reconciliation.request({
+  'start_date'=> '20120202',
+  'end_date'=> '20120205'
+})
+
+# Results: Alipay will respond with either the file's array of results, false, or throw an ArgumentError?
+# => "false"
+```
+
+
+
+#### Results
+
+**Failure Case 1** : No transactions found
+```ruby
+AlipayGlobal::Service::Reconciliation.request(params)
+
+# Results: If no transaction records found
+# => "false"
+```
+
+**Failure Case 2** : Errors in arguments
+Argument Error with the following messages will be thrown
+
+| Error Message | Description |
+| ------------- | ----------- |
+| File download failed:Over 10 days to Date period | The supplied date range exceeds 10 days |
+| <?xml version=\"1.0\" encoding=\"GBK\"?>\n<alipay><is_success>F</is_success><error>ILLEGAL_PARTNER</error></alipay> | Partner id that is set does not exist in Alipay's system/ or isn't active in the production/testing environment yet |
+| File download failed:Finish date ahead of begin date | Invalid date types supplied |
+| File download failed:Illegal Date period! | No date/ Invalid date data |
+| File download failed:Finish date not ahead of today | Dates supplied for reconciliations should be before current date (Alipay's probably) |
+
+**Untested Cases**
+The following cases have yet to be tested
+
+| Errors | Description |
+| ------ | ----------- |
+| Date format incorrect YYYYMMDD | Unable to recreate scenario |
+| System exception |  |
+| Internet connected exception ,please try later |  |
+
+**Success Case** : Array containing the results of transactions in these periods.
+
+```ruby
+AlipayGlobal::Service::Reconciliation.request(params)
+
+# Results: If no transaction records found
+# => [
+{:partner_transaction_id=>"20131219-144657-234", :amount=>"0.11", :currency=>"EUR", :transaction_time=>#<DateTime: 2013-12-19T21:52:28+00:00 ((2456646j,78748s,0n),+0s,2299161j)>, :settlement_time=>"", :transaction_type=>"P", :service_charge=>"0.00", :status=>"P", :remarks=>"Test"}, 
+{:partner_transaction_id=>"1326557", :amount=>"2125.25", :currency=>"HKD", :transaction_time=>#<DateTime: 2013-12-19T17:58:40+00:00 ((2456646j,64720s,0n),+0s,2299161j)>, :settlement_time=>"", :transaction_type=>"P", :service_charge=>"21.25", :status=>"P", :remarks=>"Grey Hours Limited (Testing)"}, 
+{:partner_transaction_id=>"1326555", :amount=>"2125.25", :currency=>"HKD", :transaction_time=>#<DateTime: 2013-12-19T17:56:37+00:00 ((2456646j,64597s,0n),+0s,2299161j)>, :settlement_time=>"", :transaction_type=>"P", :service_charge=>"21.25", :status=>"P", :remarks=>"Grey Hours Limited (Testing)"}, 
+{:partner_transaction_id=>"1326244", :amount=>"0.01", :currency=>"HKD", :transaction_time=>#<DateTime: 2013-12-19T16:11:26+00:00 ((2456646j,58286s,0n),+0s,2299161j)>, :settlement_time=>"", :transaction_type=>"P", :service_charge=>"0.00", :status=>"P", :remarks=>"MICROS-Fidelio Information Systems Co. Limited (Testing)"}
+]
+```

data/Rakefile

@@ -0,0 +1,9 @@
+require "bundler/gem_tasks"
+require "rake/testtask"
+
+Rake::TestTask.new do |t|
+  t.libs << "test"
+  t.test_files = FileList['test/**/*_test.rb']
+end
+
+task :default => :test

data/alipay_global.gemspec

@@ -0,0 +1,27 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'alipay_global/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "alipay_global"
+  spec.version       = AlipayGlobal::VERSION
+  spec.authors       = ["Melvrick Goh, Ng Junyang, Grzegorz Witek"]
+  spec.email         = ["melvrickgoh@kaligo.com"]
+  spec.description   = %q{An unofficial simple global.alipay gem}
+  spec.summary       = %q{An unofficial simple global.alipay gem}
+  spec.homepage      = "https://github.com/Kaligo/alipay-global.git"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.3"
+  spec.add_development_dependency "rake"
+  spec.add_development_dependency "minitest"
+  spec.add_development_dependency "rspec"
+  spec.add_development_dependency "fakeweb"
+  spec.add_development_dependency "nokogiri"
+end

data/keys/alipay_public_key.pem

@@ -0,0 +1,6 @@
+-----BEGIN PUBLIC KEY-----
+MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQCnxj/9qwVfgoUh/y2W89L6BkRA
+FljhNhgPdyPuBV64bfQNN1PjbCzkIM6qRdKBoLPXmKKMiFYnkd6rAoprih3/PrQE
+B/VsW8OoM8fxn67UDYuyBTqA23MML9q1+ilIZwBC2AQ2UBVOrFXfFl75p6/B5Ksi
+NG9zpgmLCUYuLkxpLQIDAQAB
+-----END PUBLIC KEY-----

data/keys/test_private_key.pem

@@ -0,0 +1,27 @@
+-----BEGIN RSA PRIVATE KEY-----
+MIIEpAIBAAKCAQEAxF1vOOysBibP9gquwCqjCigUBIGZpPsTiAyeGvt38NRwixPI
+56wZgVvCMp02pVBWH7np99Qi91Axg1/A7j1z4MAqBru6XNPgn2LLIEv8xuSvJ0mI
+YeB1MXZOttD2tsaNgFdU0LQsSz+HEicSfh5/1xJ5nCwQmJg/2AIGOL1igcAkqCct
+cs4umwK9GFQ1FROsqz4OXUbjzByuCxmY9C5r4ALAycmjKhsy9luE1Pp9VEzT0jeJ
+xfAH0vAPkGCqNv50swxJ6n+s98/ves/XmxXL3dIxAW/6RvmriNXwANsuwyn0DMsv
+u1nFMZIxeCUvfwmrwkpGb5lHFBvW9pTbOCOMIwIDAQABAoIBACjRX0hO8idJNBtp
+9w9dDY0T7a1OH1kLE/FI5iinszPthQNz9mQqAxc/squAwJY2j+CCbd8lSqtsEQ7E
+/b7IKWlDqLjDlyaqqFuZVq38/at+Z+Zbw6zM0q+Ybx5Ta6Vsuoc+IBROD5MIvpQI
+aTCsOFjFr1/GTSDbLRJCwXZT78EWiYMDnDscmvAQ/3A7c+2uQcMUAUMsPZ1gi0WY
+2IdNetD9D2bwowYwoCJ82BKlciqxx2bL9ue3KnFea01pvQFisOjO69421C1baqV2
+6ghT001ghrL80SvG7SNuArEGSqm+WeUC3/BoeK1/1BEsrgiXFVZZvvrMcQwWWetk
+JOkJTskCgYEA6DfE2a44tdIN2spg4Wl5O/pRAA4cnpBsKCL/RYTaIXmHj5tDyqlO
+oRrJuVQBesv2WDxTwaqRDA7Wbro3jtWObKHtXiiPNKw4bb2OpODdIlJXLLvRpXkq
+PhiO1+0RaBX3TGyVs+JJvNWZVAj03IeMNfzjZq18fkLwDYw1PUqgNrcCgYEA2Hmv
+B9Ee/SkFbheM6KYYBGNSCU6qxb0C6aaOFKrq8Ryml/3Li4Q+nFwzDiFQHPhM0m4e
+mv5y/mMGR2jnkn/KwKYa3jTICp+F/ilkAop0k8yKcXrdVkb/Fb/lQw2pkqkLbKaG
+/Ao20TS+hlWjAZfpvU2aVqS215PTyO6I4L9zSfUCgYEA5djtexi7ARycogbWxcaE
+PR2Stx9ArKH+q+uYB9NrpN6Jk1b3Ts0uCsBdEpdXr5faiZOMw5B0aR72mDqxaytu
+AZB1RlGXDWe5osWRPxljR+mAZ8Kvy72WVkgwewEnzYKQeJCxzI8atVImpcsHspBn
+87gPzT3Cj6bpvD8fIz+OPRkCgYAdMINGdY9NKavexXQtpr/UT6QvNxlV4n+zC89a
+wBU//9IC6qj4nhNnOBN2U02fKmgJc+nSkn7lCGs/U8jt+ydWxM8YqVtT+2Cw/dnL
+cen4R/tfA+c2jAo3X5HFceEssnik5OuMrr/ng8oxCPka7OYKrZ0jE8DH3toO3QM9
+8vLTxQKBgQDTQSlorlACRywudw2KE4Li7yRM9CodwBnIJPGze8N+54f3uxxc39AZ
+9jT6UeK/vaiuD9VrPxF5Ze4/ZPaHctMy5O2uD4m+zPTBQo/uUGBg4m++i8b3PWfx
+e8OjaXP26YiACWG/RRan8R0ZRPy8M/zLgFJUMiNrSrxchUrVXoiM4w==
+-----END RSA PRIVATE KEY-----

data/keys/test_public_key.pem

@@ -0,0 +1,9 @@
+-----BEGIN PUBLIC KEY-----
+MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAxF1vOOysBibP9gquwCqj
+CigUBIGZpPsTiAyeGvt38NRwixPI56wZgVvCMp02pVBWH7np99Qi91Axg1/A7j1z
+4MAqBru6XNPgn2LLIEv8xuSvJ0mIYeB1MXZOttD2tsaNgFdU0LQsSz+HEicSfh5/
+1xJ5nCwQmJg/2AIGOL1igcAkqCctcs4umwK9GFQ1FROsqz4OXUbjzByuCxmY9C5r
+4ALAycmjKhsy9luE1Pp9VEzT0jeJxfAH0vAPkGCqNv50swxJ6n+s98/ves/XmxXL
+3dIxAW/6RvmriNXwANsuwyn0DMsvu1nFMZIxeCUvfwmrwkpGb5lHFBvW9pTbOCOM
+IwIDAQAB
+-----END PUBLIC KEY-----

data/lib/alipay_global.rb

@@ -0,0 +1,32 @@
+require 'alipay_global/sign'
+require 'alipay_global/sign/md5'
+require 'alipay_global/sign/rsa'
+require 'alipay_global/sign/dsa'
+
+require 'alipay_global/utils'
+
+require 'alipay_global/service'
+require 'alipay_global/service/trade'
+require 'alipay_global/service/exchange'
+require 'alipay_global/service/notification'
+require 'alipay_global/service/reconciliation'
+
+module AlipayGlobal
+  
+  @debug_mode = true
+  @sign_type = "MD5"
+  @environment = "TEST"
+
+  #default alipay test credentials
+  @api_partner_id = "2088101122136241"
+  @api_secret_key = "760bdzec6y9goq7ctyx96ezkz78287de"
+
+  class << self
+    attr_accessor :api_partner_id, :api_secret_key, :sign_type, :debug_mode, :private_key_location, :environment
+
+    def debug_mode?
+      !!@debug_mode
+    end
+
+  end
+end

data/lib/alipay_global/service.rb

@@ -0,0 +1,35 @@
+module AlipayGlobal
+  module Service
+    def self.gateway_url
+      AlipayGlobal.environment == "PRODUCTION" ? "https://mapi.alipay.com/gateway.do?" : "https://mapi.alipay.net/gateway.do?"
+    end
+
+    def self.request_uri(params, sign = true)
+      uri = URI(gateway_url)
+      processed_params = sign ? sign_params(params) : params
+      uri.query = URI.encode_www_form(processed_params)
+      uri
+    end
+
+    def self.sign_params(params)
+      params.merge(
+        'sign_type' => AlipayGlobal.sign_type.upcase,
+        'sign'      => AlipayGlobal::Sign.generate(params)
+      )
+    end
+
+    def self.check_required_params(params, names)
+      return if !AlipayGlobal.debug_mode?
+
+      names.each do |name|
+        warn("AlipayGlobal Warn: missing required option: #{name}") unless params.has_key?(name)
+      end
+    end
+
+    def self.check_optional_params(params, names)
+      return if !AlipayGlobal.debug_mode?
+
+      warn("AlipayGlobal Warn: must specify either #{names.join(' or ')}") if names.all? {|name| params[name].nil? }
+    end
+  end
+end