支付开发指南
目录 |
支付接口调用说明
支付接入时序图
接口调用说明
- 微币支付的实现流程概述如下:
- 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接口
- B. 付款接口
- C. 回调接口
- 测试URL: 在申请虚拟支付ID时,开发者填写的回调地址;
- 线上URL:在申请开通支付功能时(即“支付ID”),开发者填写的回调地址。
- D. 查看订单状态接口
接口文档
线上环境接口文档:
接口一:get_token接口
- 用户发起支付时,应用开发者调用get_token接口,获取支付token,开放平台验证应用相关信息,**验证成后,返回token值。
接口二:付款接口
- 成功获取token后,提交订单信息生成表单**成功获取token后,提交订单信息生成表单(表单参数)给开放平台。开放平台验证表单信息,验证通过则页面跳转至“付款页”,用户可进行付款操作;如果验证不通过,则返回报错信息。
- 说明:调用“付款接口”前,必须需先获取支付token(即:调用get_token接口)。
接口三:回调接口
- 当用户付款成功后,开放平台通过 “回调接口”将支付成功信息通知给开发者。
- 在收到通知时,要求开发者给予响应。如开发者无响应,开放平台会总计调用三次“回调接口”通知开者。
- 说明: 应用开发者申请开通支付功能时,需要填写回调地址。应用成功开通支付功能后,开发者可在线上自行
- 修改回调地址。
接口四:查询订单状态接口
- 用户支付成功后,开放平台通过 “回调接口”将订单支付成功信息通知给开发者;如果开发者没有收到开
- 放平台的任何回调信息,则可调用“查看订单状态接口”来获取订单支付状态。