a rails plugin for integrating kuaiqian(快钱,99bill) payment gateway.
Ruby
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
lib
spec
tasks
.gitignore
MIT-LICENSE
README
Rakefile
VERSION
kuaiqian.gemspec

README

快钱
======

用于支持快钱(http://99bill.com/)支付网关的Rails插件。
演示代码:http://github.com/yzhang/kuaiqian_demo

集成
=======

1. 修改Gemfile:

gem "kuaiqian"

2. 生成配置文件:

$ script/rails g kuaiqian

这个命令会在你的应用的config目录创建一个kuaiqian.yml文件,默认是快钱提供的测试帐号(关于测试帐号的使用方法请参看测试章节)
将kuaiqian.yml中的商户ID和密钥替换为快钱提供给你的真实ID和密钥然后进行下一步。

3. 下面的代码会创建一笔新订单:

  @request = Kuaiqian::Request.new('产品名称', # 产品名称
                  1, # 订单ID,必须全局唯一
                  Time.now, # 订单生成时间,格式为20091104174132
                  4500, # 订单金额,以分为单位
                  'http://return', # 通知地址,用户支付成功后快钱会通过此地址通知商户支付结果
                  '00', # 支付类型,00显示所有方式,10只显示银行卡方式,11只显示电话银行方式,12只显示快钱帐户支付方式,13只显示线下方式
                  'attach', #自定义数据,会在返回URL中原样返回
                  'name') #订单支付人名称
  redirect_to @request.url

上面的代码会将用户重定向到快钱的支付页面。

4. 在用户完成支付后,快钱会调用你在支付请求中提供的返回URL:

  @response = Kuaiqian::Response.new(params)
  if @response.successful?
    # 支付成功
  else
    # 支付失败
  end
  
注意,快钱可能会多次调用你的返回URL,并将结果展现给用户,因此你的代码要考虑多次执行后的输出对用户的有好度。

测试
=======

要使用快钱提供的测试ID,需要修改你的hosts文件,将快钱的域名指向测试服务器:

218.242.247.5 www.99bill.com

然后使用下面的帐号进行支付:

用户名:kquser02@sina.com 
密码:99bill

----------------
如果在使用中遇到任何的问题或者建议,欢迎和我联系: zhangyuanyi@gmail.com

Copyright (c) 2009 Yuanyi Zhang, released under the MIT license