手机网站支付老接口升级指导

支付产品全面升级,若您使用的是老接口,请移步老版本手机网站支付文档

若您希望从手机网站支付老版本升级为手机网站支付新版本,请参考以上的快速接入部分即可。

若想了解更多关于新版本的升级改造内容,可参考以下内容。

产品签约对比说明 

原使用手机网站支付老版本的商户,在做手机网站支付新版本升级时,需要重新签约新版的手机网站支付。签约新版协议之后,新老接口同时有使用权限,但不建议新老接口同时使用。对于新版手机网站支付产品,您可以通过创建应用,并且在应用中添加功能(如下图1),来获取手机网站支付新版本产品功能(如下图2)。应用添加新产品功能后,会引导您完成签约,完成签约后就可以在线上正常调用接口(注:手机网站支付新版本未签约且应用没上线时,只能在沙箱环境下联调)。

图1

 图2

密钥配置对比说明

1. 密钥生成

目前手机网站支付老版本仅支持RSA签名方式,手机网站支付新版本支持RSA和RSA2两种签名方法。

两种签名方法的区别可以参见RSA和RSA2签名算法区别。同时可以参考1024位和2048位密钥生成工具来生成相应位数的密钥。

2. RSA/RSA2商户公钥上传

a) 手机网站支付老版本:只能上传RSA商户公钥。登录b.alipay.com进入“我的商家服务-签约管理-查看PID和KEY”进入密钥配置模块后,在“mapi网关产品密钥”处进行密钥配置,配置完成后可以获取支付宝公钥(ALIPAY_PUBLIC_KEY);也可以在开放平台账户中心的“mapi网关产品密钥”处进行密钥配置(如下图3)。

图3

b) 手机网站支付新版本:登录open.alipay.com后,在开放平台管理中心找到该应用进行RSA/RSA2密钥配置和支付宝公钥的获取(ALIPAY_PUBLIC_KEY)。

技术接入对比说明

1. 请求网关变化

手机网站支付老版本请求支付宝的网关地址为:https://mapi.alipay.com/gateway.do;

手机网站支付新版本请求支付宝的网关地址为:https://openapi.alipay.com/gateway.do;

2. 请求参数签名

手机网站支付老版本和新版本的签名和验签规则不同。我们提供了手机网站支付新版本服务端SDK,包含JAVA、PHP和.NET三语言版本,封装了签名&验签、HTTP接口请求等基础功能。为了避免签名错误,请先下载对应语言版本的SDK并引入您的开发工程。

3. 同步返回和异步通知的验签

手机网站支付新老版本的同步返回/异步通知的验签方式都有变化,为了避免报签名错误,强烈建议手机网站支付新版本接入时使用服务端SDK解析。

4. 请求参数对比(只列出部分差异参数,详细参数及说明见如下链接

参数 手机网站支付1.0请求参数 手机网站支付2.0请求参数
service 接口名称:alipay.wap.create.direct.pay.by.user
method 接口名称:alipay.trade.wap.pay
partner 支付宝账号对应的支付宝唯一用户号
_input_charset 编码格式,固定为UTF-8
charset 请求使用的编码格式,如utf-8,gbk,gb2312等
format 仅支持JSON
biz_content 业务请求参数的集合,最大长度不限,除公共参数外所有请求参数都必须放在这个参数中传递
app_id 必填,支付宝分配给开发者的应用ID,获取APPID
timeout_express 用it_b_pay表示 交易超时时间
total_amount 用total_fee代表 订单总金额
total_fee 订单总金额 用total_amount代表
app_pay 是否使用支付宝客户端支付,如需使用支付宝客户端,该参数必传。 无该参数,默认唤起支付宝客户端
show_url 添加该参数后在h5支付收银台会出现返回按钮,可用于用户付款中途退出并返回到该参数指定的商户网站地址。 以quit_url参数实现
Passback_params 公用回传参数,如果请求时传递了该参数,则返回给商户时会回传该参数。
Extend_params 业务扩展参数
... 更多 更多

注:其中手机网站支付新版本中的biz_content参数,除公共参数外所有请求参数都必须放在这个参数中传递。

5. 异步通知参数差异(只列出部分差异参数,详细参数及说明见如下链接

参数 手机网站支付老版本异步通知参数 手机网站支付新版本异步通知参数
app_id  支付宝分配给开发者的应用Id
charset 编码格式
version 接口版本
Out_biz_no 商户业务号
total_amount 用total_fee代表 订单金额
receipt_amount 实收金额
invoice_amount 开票金额
buyer_pay_amount 付款金额
point_amount 集分宝金额
refund_fee 总退款金额
fund_bill_list 支付金额信息
quantity 购买数量
price 商品单价
refund_status 退款状态
total_fee 交易金额 用total_amount代表
Passback_params 回传参数
... 更多 更多

6. 交易辅助接口对比

接口描述 手机网站支付老版本交易辅助接口 手机网站支付新版本交易辅助接口
交易查询 single_trade_query alipay.trade.query
交易关闭 无(不再对外提供) alipay.trade.close
交易退款 refund_fastpay_by_platform_nopwd
refund_fastpay_by_platform_pwd
alipay.trade.refund
交易退款查询 无(不再对外提供) alipay.trade.fastpay.refund.query
对账 account.page.query alipay.data.dataservice.bill.downloadurl.query

新版手机网站支付交易辅助接口

7. 沙箱联调说明

手机网站支付老版本暂不支持沙箱环境联调;手机网站支付新版本目前支持沙箱联调,具体可参见沙箱联调指南

onlineServer