申请以及集成 Stripe 的 Alipay 支付方案

        最近在一个项目需要支持人民币支付,并且客户要求希望能够收完款后的结算是用美元,所以就想到了去年 Stripe 宣布已经跟支付宝达成合作意向,所以经过一番咨询跟集成,终于把 Stripe 集成进来,并且启用了支付宝收款。这篇文章介绍功能申请以及集成的完整过程。

功能申请

  1. 注册 Stripe 账号
  2. 加入 beta 用户组,电子邮箱跟注册的 Stripe 账号保持一致;
  3. 联系 Stripe 员工
    发送邮件到 support@stripe.com,声明你需要在你的 Stripe 账号中启用 Alipay 的支付功能,并且提供你的 Stripe 账号。然后,等待回复就是,一般当天都能收到回复的。

集成

0. 时序图(可结合后边代码一起理解)

Stripe 支付流程

1. 引入 stripe.js 以及初始化脚本

假设支付页面上有个开始支付按钮,其 html 代码为:

1
<button id='pay'>支付</button>

请在 html 代码里合适的地方(比如<body>标签的底部)加载 stripe.js:

1
<script src="https://checkout.stripe.com/checkout.js"></script>

在脚本中初始化 stripe.js,并且注册支付按钮的事件监听函数:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
$(function(){
  var stripeHandler = StripeCheckout.configure({
    key: 'pk_test_xxxxxxxxxxxxxxxxxxxxxxxx',  // 可以查看 https://dashboard.stripe.com/account/apikeys
    image: 'https://placehold.it/200x200',    // 显示在支付对话框的图片,可自己指定
    alipay: true,                             // 启用支付宝支付
    token: function(token){                   // 用户填写完资料并且 Stripe 校验成功后的回调函数
      // 此时应该提交 token.id 到后台,比如 http://example.com/orders/1?stripeToken={token.id}
    }
  })

  $('#pay').click(function(){
    stripeHandler.open({
      name: 'Business Name',                  // 收款方或商家名称,比如 Beansmile
      description: "商品描述内容",              // 待支付商品的描述
      amount: 50 * 100,                       // 支付金额,单位是“分”
      opened: function(){                     // 支付对话框打开后的回调函数
        // Do something
      }
    });
  });
});

2. 通过 token 请求收款

服务器端是 Ruby on Rails 实现,所以在 Gemfile 中引入 Stripe 官方的 Ruby SDK(具体配置方法请自行查阅其 README):

1
2
3
4
# Gemfile
# Stripe Ruby bindings
# https://github.com/stripe/stripe-ruby
gem "stripe", "~> 1.20.1"

然后在 Controller action 中添加处理逻辑:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
# app/controllers/orders_controller.rb
class OrdersController < ApplicationController
  # PUT /orders/:id
  #
  # params:
  #   id: 订单的 id
  #   stripeToken: 客户端完成支付流程,在脚本的回调函数中会得到 `token.id`,
  #                将其上传到 `stripeToken` 参数,服务器端用此 token 请求收款
  #
  def pay
    response = Stripe::Charge.create  amount: order.amount_in_cents,
                                      currency: 'USD',
                                      source: params[:stripeToken],
                                      description: "订单描述"
    order.update_attribute :state, :paid
    redirect_to order
  rescue Stripe::InvalidRequestError => error
    flash[:error] = "由于#{error.message},支付失败!"
    redirect_to order
  end
end

3. 效果预览

stripe 支付流程演示

其他

  1. 关于 Stripe 的沙盒机制
    Stripe 为每个账号都提供了两组 keys,一组 key 用于用于 live 环境,另一组是 test 环境,后者即是沙盒环境,而针对支付宝的沙盒,可用任意合法的邮箱账号进行测试,但验证码是固定的 123456,而身份证后 6 位是固定的 12345;
  2. 在功能申请过程中,一定要记得完成步骤3——联系 Stripe 开通 Alipay 支付功能。否则,会在支付的时候出现错误,错误信息示例为:There is no token with ID atok_xxxxxxxxxxxxxxxxxxxxxxxx
  3. 实际开发中,请结合考虑用 stripe 提供的 webhook 处理支付状态变迁;
  4. 此支付机制中,付款人可用人民币支付,但是 Stripe 会用美元跟商家(收款方)进行结算;
  5. 我总结了工作中集成过的其他几款支付网关,横向对比了各家的异同点,有兴趣的请戳:讲稿网:Payment Gateways

参考链接

  1. Stripe: Alipay 首页
  2. Stripe: Alipay FAQ
  3. Stripe: Alipay 集成文档
  4. Stripe: Checkout,这部分的文档虽然没有提交 Alipay, 但是针对 Alipay 的集成,依旧适用。

Comments