A simple alipay ruby gem, without unnecessary magic or wraper, it's directly facing how alipay api works.
It contain this API:
- Generate payment url
- Send goods
- Verify notify
Please read alipay official document first: https://b.alipay.com/order/techService.htm .
Add this line to your application's Gemfile:
gem 'alipay', '~> 0.0.2'
or development version
gem 'alipay', :github => 'chloerei/alipay'
And then execute:
$ bundle
Alipay.pid = 'YOUR_PID'
Alipay.key = 'YOUR_KEY'
Alipay.seller_email = 'YOUR_SELLER_EMAIL'
options = {
:out_trade_no => 'YOUR_ORDER_ID', # 20130801000001
:subject => 'YOUR_ORDER_SUBJECCT', # Writings.io Base Account x 12
:logistics_type => 'DIRECT',
:logistics_fee => '0',
:logistics_payment => 'SELLER_PAY',
:price => '10.00',
:quantity => 12,
:discount => '20.00'
:return_url => 'YOUR_ORDER_RETURN_URL', # https://writings.io/orders/20130801000001
:notify_url => 'YOUR_ORDER_NOTIFY_URL' # https://writings.io/orders/20130801000001/alipay_notify
}
Alipay::Service.create_partner_trade_by_buyer_url(options)
# => 'https://mapi.alipay.com/gateway.do?out_trade_no=...'
You can redirect user to this payment url, and user will see a payment page for his/her order.
Current support three payment type:
Alipay::Service#create_partner_trade_by_buyer_url # 担保交易
Alipay::Service#trade_create_by_buyer_url # 标准双接口
Alipay::Service#create_direct_pay_by_user_url # 即时到帐
options = {
:trade_no => 'TRADE_NO',
:logistics_name => 'writings.io',
:transport_type => 'DIRECT'
}
Alipay::Service.send_goods_confirm_by_platform(options)
# => '<!xml version="1.0" encoding="utf-8"?><alipay><is_success>T</is_success></alipay>'
# example in rails
# The notify url MUST be set when generate payment url
def alipay_notify
# except :controller_name, :action_name, :host, etc.
notify_params = params.except(*request.path_parameters.keys)
if Alipay::Notify.verify?(notify_params)
# valid notify, code your business logic.
render :text => 'success'
else
render :text => 'error'
end
end
Bug report or pull request are welcome.
- Fork it
- Create your feature branch (
git checkout -b my-new-feature
) - Commit your changes (
git commit -am 'Add some feature'
) - Push to the branch (
git push origin my-new-feature
) - Create new Pull Request
Please write unit test with your code if necessary.
Donate to maintainer let him make this gem better.
Alipay donate link: https://me.alipay.com/chloerei .