0.01
No commit activity in last 3 years
No release in over 3 years
Ruby wapper for Unionpay's Open API.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Runtime

~> 1.10
>= 0
~> 10.0
>= 0
 Project Readme

UnionpayOpen

http://open.unionpay.com

Ruby wapper for Unionpay(银联支付)'s Open API.

Installation

Add this line to your application's Gemfile:

gem 'unionpay_open'
# or
gem 'unionpay_open', :git => 'git://github.com/yanyingwang/unionpay_open.git'

And then execute:

$ bundle

Or install it yourself as:

$ gem install unionpay_open

Usage

配置

UnionpayOpen.config do |unionpay|
  unionpay.pfx_file = 'tmp/acp.pfx'
  unionpay.pfx_file_password = '000000'
  unionpay.ca_file = 'tmp/acp.cer'
  unionpay.merchant_no = '111111111111111'

  # unionpay.env = 'production'     # 默认值为'development',其可自动识别rack环境。
                                    # 如: ENV['RACK_ENV']如果为'production',此gem则会自动加载为production环境。
                                    # 可通过`UnionpayOpen.env`来检查确定Gem当前使用的环境。
                                    # 此值的设定,主要影响`UnionpayOpen.endpoint`的值,即请求的银联网关地址。

end

查看

配置载入完成后,可以通过如下命令查看配置文件内容:

UnionpayOpen.env
UnionpayOpen.endpoint

UnionpayOpen.pfx_file
UnionpayOpen.merchant_no

UnionpayOpen.pkcs12
UnionpayOpen.pkcs12.to_s
UnionpayOpen.pkcs12.certificate.serial.to_s

UnionpayOpen.x509_certificate.public_key.to_s
UnionpayOpen.x509_certificate.serial.to_s

单位转换

银联接口总额使用分做单位,可以如如下方法转换:

# 10000分 = 100元
UnionpayOpen.fen2yuan(10000)


# 100.1元 = 10010分
UnionpayOpen.yuan2fen(100.1)

前台交易请求地址(默认为支付,即txnType = 01)

response = UnionpayOpen::Wap.front_trans_req( front_url: 'http://test.com',
											  order_id: "abcd1qaz",
											  txn_amt: "10000" )
# response 正常情况将输入银联请求结果,为HTML页面代码。

后台交易请求地址(默认为退货,即txnType = 04)

response = UnionpayOpen::Wap.back_trans_req( backUrl: 'http://test.com',
                                             orderId: "abcd1qaz",
                                             origQryId: "201509151115244444444",
                                             txnAmt: "10000" )

注意

  1. 方法名支持按照ruby规范,用snake方式(下划线连接单词)书写,Gem会在内部自动进行转换以适应银联接口。

  2. 调用Gem时传入的参数默认只需包含必要字段(如front_trans_req只需front_url, order_id, txn_amt),其他字段如果也作为参数传入,将覆盖UnionpayOpen内部已经默认定义的值。

  3. debug需要,可在方法后添加一个block,来查看请求到银联的参数,如下示例代码:

# 查看其他字段默认值:
UnionpayOpen::Wap.front_trans_req {}

# 查看请求到银联接口的全部参数:
UnionpayOpen::Wap.front_trans_req( front_url: 'http://test.com',
											  order_id: "abcd1qaz",
											  txn_amt: "10000" ) {}

Development

After checking out the repo, run bin/setup to install dependencies. Then, run rake rspec to run the tests. You can also run bin/console for an interactive prompt that will allow you to experiment.

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.

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/unionpay_open. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.