2013年12月10日 (二) 11:14的版本

支付接口调用说明

支付接入时序图

接口调用说明

• 微币支付的实现流程概述如下：

• 1、用户购买虚拟商品
• 2、开发者调用get_token 接口( PHP调用示例 ) 获取支付token , 并生成表单（表单参数）提交给开放平台， 开放平台验证表单信息，验证通过则页面跳转至“付款页”。
• 3、用户在付款页，选择一个支付渠道进行付款。
• 4、用户付款成功后，开放平台通过 “回调接口”将支付成功信息通知给开发者。

• • （如开发者未收到回调信息，则可调用“查看订单状态接口”查询订单状态）

开发者接入支付说明

• 为了给开发者提供“便捷的支付接入流程”，让开发者更高效的调试支付接口，我们提供了“线上环境、测试
• 环境”两套环境供开发者使用。

• 说明：目前，支付接入流程仅向公司开发者开放，暂不向个人开发者开放。

• 线上环境：

• 1、应用已通过支付审核（即：已获得“支付ID”），则调用“线上环境”调试支付接口。
• 2、无论开发者的产品是否对外提供服务，在线上环境，产生的所有交易都是真实有效的，相关金额会累计进
  • 行月结算。

• 测试环境：

• 1、应用未通过支付审核但已通过文案，可申请“虚拟支付ID”；若已获得“虚拟支付ID”，则可调用“测试环境”调
  • 试支付接口。
• 2、在测试环境，所有交易流程都是模拟支付流程，期间不会产生真实的交易，也不涉及到结算流程。
• 3、如果在测试环境，所有支付接口已调通，测试报告显示“测试通过”；其“虚拟支付ID”也不能在线上进行使
  • 用，如需在线上对用户提供支付服务，需要获得“支付ID”，即：应用需审核通过。

从测试环境切换到线上环境，如何调整代码？

• 如果开发者在测试环境已调通接口（即：测试报告显示“测试通过”），则在线上环境，代码仅需做以下几个变更，即可在线上环境使用。

• 1、将“虚拟支付ID”替换为“支付ID”；

• 2、更改接口URL，从测试URL切换到线上URL，详情如下：
• A. Get_token接口
  • 测试URL: http://pay.api.weibo.com/test/pay/get_token.{xml/json}
  • 线上URL: http://pay.api.weibo.com/pay/get_token.{xml/json}
• B. 付款接口
  • 测试URL: http://open.weibo.com/paytest/payTestPay.php
  • 线上URL: http://pay.weibo.com/wb/?c=pay
• C. 回调接口
  • 测试URL: 在申请虚拟支付ID时，开发者填写的回调地址；
  • 线上URL：在申请开通支付功能时（即“支付ID”），开发者填写的回调地址。
• D. 查看订单状态接口
  • 测试URL: http://pay.api.weibo.com/test/pay/order_status.{xml/json}
  • 线上URL: http://pay.api.weibo.com/pay/order_status.{xml/json}

接口文档

接口一：get_token接口

• • 用户发起支付时，应用开发者调用get_token接口，获取支付token，开放平台验证应用相关信息，**验证成后，返回token值。

• • 说明：应用开发者申请开通支付功能时，需要填写回调地址（参见回调接口）；当用户付款成功后，**开放平台调用“回调接口”通知开发者订单支付状态。

• • 查看接口详情

• • PHP调用示例

接口二：付款接口

• • 成功获取token后，提交订单信息生成表单**成功获取token后，提交订单信息生成表单(表单参数)给开放平台。开放平台验证表单信息，验证通过则页面跳转至“付款页”，用户可进行付款操作；如果验证不通过，则返回报错信息。

• • 说明：调用“付款接口”前，必须需先获取支付token（即：调用get_token接口）。

• • 查看接口详情

• • 表单参数

接口三：回调接口

• • 当用户付款成功后，开放平台通过 “回调接口”将支付成功信息通知给开发者。
  • 在收到通知时，要求开发者给予响应。如开发者无响应，开放平台会总计调用三次“回调接口”通知开者。

• • 说明: 应用开发者申请开通支付功能时，需要填写回调地址。应用成功开通支付功能后，开发者可在线上自行
  • 修改回调地址。

• • 查看接口详情

接口四：查询订单状态接口

• • 用户支付成功后，开放平台通过 “回调接口”将订单支付成功信息通知给开发者；如果开发者没有收到开
  • 放平台的任何回调信息，则可调用“查看订单状态接口”来获取订单支付状态。

• • 查看接口详情

• • PHP调用示例