手机网站支付
支付产品全面升级，若您使用的是老接口，请移步老版本手机网站支付文档。
若您希望从手机网站支付老版本升级为手机网站支付新版本，请参考以上的快速接入部分即可。
若想了解更多关于新版本的升级改造内容，可参考以下内容。
产品签约对比说明
原使用手机网站支付老版本的商户，在做手机网站支付新版本升级时，需要重新签约新版的手机网站支付。签约新版协议之后，新老接口同时有使用权限，但不建议新老接口同时使用。对于新版手机网站支付产品，您可以通过创建应用，并且在应用中添加功能（如下图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. 沙箱联调说明
手机网站支付老版本暂不支持沙箱环境联调；手机网站支付新版本目前支持沙箱联调，具体可参见沙箱联调指南。
