手机网站支付快速接入

最新推荐文章于 2022-01-24 15:13:25 发布
最新推荐文章于 2022-01-24 15:13:25 发布
阅读量362 收藏 1
点赞数
文章标签： json 前端 php ViewUI

本文档展示了如何从零开始，使用蚂蚁金服开放平台服务端SDK快速接入手机网站支付产品，完成与支付宝对接的部分。

注意： 文档中的代码示例和Demo是用来阐述API基本使用方法的，仅针对大众场景。供ISV参考，特殊情况还请ISV自行扩展，确保符合自身业务需求。

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

第一步：创建应用并获取APPID

要在您的应用中使用支付宝开放产品的接口能力，您需要先去蚂蚁金服开放平台（open.alipay.com），在管理中心中创建登记您的应用，并提交审核，审核通过后会为您生成应用唯一标识（APPID），并且可以申请开通开放产品使用权限，通过APPID您的应用才能调用开放产品的接口能力。需要详细了解开放平台创建应用步骤请参考《开放平台应用创建指南》。

第二步：配置密钥

开发者调用接口前需要先生成RSA密钥，RSA密钥包含应用私钥(APP_PRIVATE_KEY)、应用公钥(APP_PUBLIC_KEY）。生成密钥后在开放平台管理中心进行密钥配置，配置完成后可以获取支付宝公钥(ALIPAY_PUBLIC_KEY)。详细步骤请参考《配置应用环境》。

第三步：搭建和配置开发环境

1. 下载服务端SDK

为了帮助开发者调用开放接口，我们提供了开放平台服务端SDK，包含JAVA、PHP和.NET三语言版本，封装了签名&验签、HTTP接口请求等基础功能。请先下载对应语言版本的SDK并引入您的开发工程。

2. 接口调用配置

各语言版本服务端SDK详细使用说明，请参考《服务端SDK使用说明》

在使用SDK调用具体API前，进行初始化，代码如下：

1
AlipayClient alipayClient = new DefaultAlipayClient(URL, APP_ID, APP_PRIVATE_KEY, FORMAT, CHARSET, ALIPAY_PUBLIC_KEY, SIGN_TYPE);
配置参数示例值解释获取方式/示例值
URL支付宝网关（固定）https://openapi.alipay.com/gateway.do
APP_IDAPPID即创建应用后生成获取见上面创建应用并获取APPID
APP_PRIVATE_KEY开发者应用私钥，由开发者自己生成获取见上面配置密钥
FORMAT参数返回格式，只支持jsonjson（固定）
CHARSET请求和签名使用的字符编码格式，支持GBK和UTF-8开发者根据实际工程编码配置
ALIPAY_PUBLIC_KEY支付宝公钥，由支付宝生成获取详见上面配置密钥
SIGN_TYPE商户生成签名字符串所使用的签名算法类型，目前支持RSA2和RSA，推荐使用RSA2RSA2

接下来，就可以用alipayClient来调用具体的API了。alipayClient只需要初始化一次，后续调用不同的API都可以使用同一个alipayClient对象。

TIPS：手机网站支付不支持第三方授权，不能代商家发起请求。

第四步：调用接口

手机网站支付产品包含两类API：

  • 页面跳转类：需要从前端页面以Form表单的形式发起请求，浏览器会自动跳转至支付宝的相关页面（一般是收银台或签约页面），用户在该页面完成相关业务操作后再回跳到商户指定页面。例如本产品中的手机网站支付接口alipay.trade.wap.pay。
  • 系统调用类：直接从服务端发起HTTP请求，支付宝会同步返回请求结果。例如本产品中的交易查询等配套API。

调用流程

调用流程

如上图所示，用户在商户的H5网站下单支付后，商户系统按照手机网站支付接口alipay.trade.wap.payAPI的参数规范生成订单数据，然后在前端页面通过Form表单的形式请求到支付宝。此时支付宝会自动将页面跳转至支付宝H5收银台页面，如果用户手机上安装了支付宝APP，则自动唤起支付宝APP。开发者需要关注安装了支付宝和未安装支付宝的两种测试场景，对于在手机浏览器唤起H5页面的模式下，如果安装了支付宝却没有唤起，大部分原因是当前浏览器不在支付宝配置的白名单内，对于商户app内嵌webview中的支付场景，建议集成支付宝App支付产品。

用户在支付宝APP或H5收银台完成支付后，会根据商户在手机网站支付API中传入的前台回跳地址return_url自动跳转回商户页面，同时在URL请求中以Query String的形式附带上支付结果参数，详细回跳参数见“手机网站支付接口alipay.trade.wap.pay”前台回跳参数。

同时，支付宝还会根据原始支付API中传入的异步通知地址notify_url，通过POST请求的形式将支付结果作为参数通知到商户系统，详情见支付结果异步通知。

除了正向支付流程外，支付宝也提供交易查询、关闭、退款、退款查询以及对账等配套API。

特别注意：

  • 由于前台回跳的不可靠性，前台回跳只能作为商户支付结果页的入口，最终支付结果必须以异步通知或查询接口返回为准，不能依赖前台回跳。
  • 商户系统接收到异步通知以后，必须通过验签（验证通知中的sign参数）来确保支付通知是由支付宝发送的。详细验签规则参考异步通知验签。
  • 接受到异步通知并验签通过后，一定要检查通知内容，包括通知中的app_id, out_trade_no, total_amount是否与请求中的一致，并根据trade_status进行后续业务处理。

使用SDK快速接入

手机网站支付alipay.trade.wap.pay：
对于页面跳转类API，SDK不会也无法像系统调用类API一样自动请求支付宝并获得结果，而是在接受request请求对象后，为开发者生成前台页面请求需要的完整form表单的html（包含自动提交脚本），商户直接将这个表单的String输出到http response中即可。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
public void doPost(HttpServletRequest httpRequest,
                       HttpServletResponse httpResponse) throws ServletException, IOException {
     AlipayClient alipayClient = new DefaultAlipayClient( "https://openapi.alipay.com/gateway.do" , APP_ID, APP_PRIVATE_KEY, "json" , CHARSET, ALIPAY_PUBLIC_KEY, "RSA2" ); //获得初始化的AlipayClient
     AlipayTradeWapPayRequest alipayRequest = new AlipayTradeWapPayRequest(); //创建API对应的request
     alipayRequest.setReturnUrl( "http://domain.com/CallBack/return_url.jsp" );
     alipayRequest.setNotifyUrl( "http://domain.com/CallBack/notify_url.jsp" );//在公共参数中设置回跳和通知地址
     alipayRequest.setBizContent( "{" +
         "    \"out_trade_no\":\"20150320010101002\"," +
         "    \"total_amount\":\"88.88\"," +
         "    \"subject\":\"Iphone6 16G\"," +
         "    \"seller_id\":\"2088123456789012\"," +
         "    \"product_code\":\"QUICK_WAP_PAY\"" +
         "  }" ); //填充业务参数
     String form = alipayClient.pageExecute(alipayRequest).getBody(); //调用SDK生成表单
     httpResponse.setContentType( "text/html;charset=" + AlipayServiceEnvConstants.CHARSET);
     httpResponse.getWriter().write(form); //直接将完整的表单html输出到页面
     httpResponse.getWriter().flush();
}

关键入参：

参数名称参数说明
out_trade_no商户订单号，需要保证不重复
subject订单标题
seller_id实际收款账号，一般填写商户PID即可
total_amount订单金额

异步通知验签：

1
2
3
4
5
6
7
Map<String, String> paramsMap = ... //将异步通知中收到的所有参数都存放到map中
boolean signVerified = AlipaySignature.rsaCheckV1(paramsMap, ALIPAY_PUBLIC_KEY, CHARSET, SIGN_TYPE) //调用SDK验证签名
if (signVerfied){
     // TODO 验签成功后，按照支付结果异步通知中的描述，对支付结果中的业务内容进行二次校验，校验成功后在response中返回success并继续商户自身业务处理，校验失败返回failure
} else {
     // TODO 验签失败则记录异常日志，并在response中返回failure.
}

关键通知参数：

参数名称参数说明
trade_no支付宝28位交易号
trade_status交易状态
total_amount订单金额

交易查询接口alipay.trade.query：

1
2
3
4
5
6
7
8
9
AlipayClient alipayClient = new DefaultAlipayClient( "https://openapi.alipay.com/gateway.do" , APP_ID, APP_PRIVATE_KEY, "json" , CHARSET, ALIPAY_PUBLIC_KEY, "RSA2" ); //获得初始化的AlipayClient
AlipayTradeQueryRequest request = new AlipayTradeQueryRequest(); //创建API对应的request类
request.setBizContent( "{" +
"    \"out_trade_no\":\"20150320010101001\"," +
"    \"trade_no\":\"2014112611001004680073956707\"" +
"  }" ); //设置业务参数
AlipayTradeQueryResponse response = alipayClient.execute(request); //通过alipayClient调用API，获得对应的response类
System.out.print(response.getBody());
//根据response中的结果继续业务逻辑处理

关键入参：

参数名称参数说明
out_trade_no支付时传入的商户订单号，与trade_no必填一个
trade_no支付时返回的支付宝交易号，与out_trade_no必填一个

关键出参：

参数名称参数说明
trade_no支付宝28位交易号
out_trade_no支付时传入的商户订单号
trade_status交易当前状态

交易退款接口alipay.trade.refund：

1
2
3
4
5
6
7
8
9
10
11
AlipayClient alipayClient = new DefaultAlipayClient( "https://openapi.alipay.com/gateway.do" , APP_ID, APP_PRIVATE_KEY, "json" , CHARSET, ALIPAY_PUBLIC_KEY, "RSA2" ); //获得初始化的AlipayClient
AlipayTradeRefundRequest request = new AlipayTradeRefundRequest(); //创建API对应的request类
request.setBizContent( "{" +
"    \"out_trade_no\":\"20150320010101001\"," +
"    \"trade_no\":\"2014112611001004680073956707\"," +
"    \"out_request_no\":\"1000001\"," +
"    \"refund_amount\":\"2014112611001004680073956707\"" +
"  }" ); //设置业务参数
AlipayTradeRefundResponse response = alipayClient.execute(request); //通过alipayClient调用API，获得对应的response类
System.out.print(response.getBody());
//根据response中的结果继续业务逻辑处理

关键入参：

参数名称参数说明
out_trade_no支付时传入的商户订单号，与trade_no必填一个
trade_no支付时返回的支付宝交易号，与out_trade_no必填一个
out_request_no本次退款请求流水号，部分退款时必传
refund_amount本次退款金额

关键出参：

参数名称参数说明
refund_fee该笔交易已退款的总金额

查询对账单下载地址接口alipay.data.dataservice.bill.downloadurl.query：

1
2
3
4
5
6
7
8
9
AlipayClient alipayClient = new DefaultAlipayClient( "https://openapi.alipay.com/gateway.do" , APP_ID, APP_PRIVATE_KEY, "json" , CHARSET, ALIPAY_PUBLIC_KEY, "RSA2" ); //获得初始化的AlipayClient
AlipayDataDataserviceBillDownloadurlQueryRequest request = new AlipayDataDataserviceBillDownloadurlQueryRequest(); //创建API对应的request类
request.setBizContent( "{" +
"    \"bill_type\":\"trade\"," +
"    \"bill_date\":\"2016-04-05\""
"  }" ); //设置业务参数
AlipayDataDataserviceBillDownloadurlQueryResponse response = alipayClient.execute(request);
System.out.print(response.getBody());
//根据response中的结果继续业务逻辑处理

关键入参：

参数名称参数说明
bill_type固定传入trade
bill_date需要下载的账单日期，最晚是当期日期的前一天

关键出参：

参数名称参数说明
bill_download_url账单文件下载地址，30秒有效

下载账单文件：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
//将接口返回的对账单下载地址传入urlStr
String urlStr = "http://dwbillcenter.alipay.com/downloadBillFile.resource?bizType=X&userId=X&fileType=X&bizDates=X&downloadFileName=X&fileId=X" ;
//指定希望保存的文件路径
String filePath = "/Users/fund_bill_20160405.csv" ;
URL url = null ;
HttpURLConnection httpUrlConnection = null ;
InputStream fis = null ;
FileOutputStream fos = null ;
try {
     url = new URL(urlStr);
     httpUrlConnection = (HttpURLConnection) url.openConnection();
     httpUrlConnection.setConnectTimeout( 5 * 1000 );
     httpUrlConnection.setDoInput( true );
     httpUrlConnection.setDoOutput( true );
     httpUrlConnection.setUseCaches( false );
     httpUrlConnection.setRequestMethod( "GET" );
     httpUrlConnection.setRequestProperty( "Charsert" , "UTF-8" );
     httpUrlConnection.connect();
     fis = httpUrlConnection.getInputStream();
     byte [] temp = new byte [ 1024 ];
     int b;
     fos = new FileOutputStream( new File(filePath));
     while ((b = fis.read(temp)) != - 1 ) {
         fos.write(temp, 0 , b);
         fos.flush();
     }
} catch (MalformedURLException e) {
     e.printStackTrace();
} catch (IOException e) {
     e.printStackTrace();
} finally {
     try {
         if (fis!= null ) fis.close();
         if (fos!= null ) fos.close();
         if (httpUrlConnection!= null ) httpUrlConnection.disconnect();
     } catch (IOException e) {
         e.printStackTrace();
     }
}

关于沙箱

如何接入沙箱

沙箱环境是开放平台提供给开发者调试接口的环境，具体操作步骤见 沙箱接入指南。

手机网站支付沙箱接入注意点

1、手机网站支付支持沙箱接入；在沙箱调通接口后，必须在线上进行测试与验收，所有返回码及业务逻辑以线上为准；
2、手机网站支付只支持余额支付，不支持银行卡、余额宝等其他支付方式；
3、支付时，请使用沙箱买家账号支付，在登录支付宝，输入手机号的页面，点击右下角 支付宝账户登录；

weixin_34007020
关注
  • 0
    点赞
  • 踩
  • 1
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
抓包抖音充值接口，实现微信支付宝充值抖币收款通道
gogozhifu的博客
12-22 1万+
前段时间搞了个抖音充值的通道，现在搞个YY充值的。 接下来这段时间的安排就是把各个这种平台的充值接口全分析一遍做成接口。 相比抖音的充值抖币接口，yy充值y币的风控就小很多，可以忽略不计，所以开发上也顺利很多。 把调用的相关接口和参数在这分享一下，具体的实现逻辑直接抓包、模拟请求挨个做下去就完事了。 以微信支付为例： 1.第一步下单 $url = 'https://pay.yy.com/userDepositCheckAction.action'; $data =.
iOS9 适配，白名单，支付宝支付时不跳转
小猴子
03-10 2186
平台名称 URL Schem 补充说明 微信 wechat, weixin   支付宝 alipay, alipayshare   QQ mqqOpensdkSSoLogin, mqqopensdkapiV2, mqqopensdkapiV3, wtloginmqq2, mqq, mqqapi  
电脑网站（手机网站）支付宝支付的配置信息（appid、商户私钥、支付宝公钥）
qq_24310891的博客
01-24 3163
需求：想在网站接入支付宝支付。现在的网站基本分为PC端和手机端。 明确工作目标：appid、商户私钥、支付宝公钥以及回调地址。 电脑PC端支付宝支付获取配置信息步骤如下： 1.登录支付宝开放平台 （传送门），使用企业认证的支付宝账户或者个人认证的支付宝账号扫码登录。（自己认证，不赘述） 2.找到网页&移动应用，选择自定义接入。企业账户和个人账号会稍有差别，我先用个人账号做演示。 3.输入应用名称、应用图标320*320px(没有严格要求)、输入网站的域名、简介（XX官方网站即..
支付宝H5支付实现 绕过浏览器白名单
嗨皮螃的博客
08-27 1万+
在开发支付宝H5支付的时候，遇到了一个很尴尬的问题，无法唤起支付宝APP问题分析：当前浏览器不在支付宝配置的白名单内 市场上的浏览器太多，总有用户会使用不一样的浏览器，就UC浏览器来说，不同版本也有出现不能唤醒支付宝APP来进行支付的时候。如何解决成了我当下的问题。 H5支付唤醒APP，本质上就是通过访问相关协议来达成的。支付宝支付的唤醒协议是 ：alipays://platformapi/startApp?appId=20000125&orderSuffix=h5_route_token%
手机网站支付唤起支付宝app
幻影浪子
10-13 1万+
商家在网页中调用支付宝提供的网页支付接口调起支付宝客户端内的支付模块，商家网页会跳转到支付宝中完成支付，支付完后跳回到商家网页内，最后展示支付结果。若无法唤起支付宝客户端，则在一定的时间后会自动进入网页支付流程。 注意： 若接入的是新版本手机网站支付接口（alipay.trade.wap.pay），用户在安装支付宝钱包的情况下，调用手机网站支付接口默认会唤起钱包支付；若接入的是手机网站支付老版...
支付宝手机网站支付demo
04-19
总的来说，支付宝手机网站支付Demo是一个实践性的教程，涵盖了从接口调用、参数配置到支付流程实现的全过程，对于理解和开发支付宝手机支付功能具有指导意义。通过学习和研究这个Demo，开发者可以快速掌握相关技术，...
.net接入支付宝的支付接口
01-03
H5手机网站接入支付宝的支付接口，推荐使用支付宝提供的SDK来快速开发 我使用的是SDK开发 引用命名空间 using Aop.Api; using Aop.Api.Request; using Aop.Api.Response; using Aop.Api.Util; 首页需要定义一些常量...
支付宝手机网站支付 demo
06-08
通过这个 Demo，开发者可以快速理解和学习如何配置和调用支付宝提供的 API 接口，以实现用户在浏览手机网站时能够无缝跳转到支付宝的支付页面完成交易。 首先，我们来了解一下“手机网站支付”这一概念。手机网站...
支付宝手机支付接口.zip
11-06
支付宝手机支付接口是支付宝官方提供的一...总之，支付宝手机支付接口是电商、服务类网站等接入支付宝支付的重要途径，通过提供的压缩包文件，开发者可以快速集成并实现在线支付功能，为用户提供安全、便捷的支付体验。
ASP支付宝手机网站接口
12-27
总的来说，ASP支付宝手机网站接口是ASP开发者实现移动支付的关键工具，它可以帮助开发者快速构建安全、高效的在线支付系统，满足移动互联网时代用户的需求。通过理解和掌握这个接口的工作原理及使用方法，开发者可以...
支付宝手机网站支付Demo
05-25
支付宝手机网站支付Demo, 手机网站支付主要应用于手机、掌上电脑等无线设备的网页上，通过网页跳转或浏览器自带的支付宝快捷支付实现买家付款的功能，资金即时到账。
alipay 手机wap支付
08-18
支付宝 网站 手机网站支付接口 可运行支付成功
网络爬虫之简单链接抓取
10-19
网络爬虫之简单链接抓取，CSDN博客上面文章http://blog.csdn.net/duishengchen/article/details/40271765 对应的pdf档及其相对应的源码。
微信连WIFI认证、微信支付、支付宝支付需配置的白名单
xianweijian的博客
06-27 4万+
列出可能用到的一些服务器IP、域名。在实现上述功能时，要保证访问这些服务器地址的链路能通。 这里提到的ip地址，针对的是电信网络环境。 微信连WI-FI认证 short.weixin.qq.com long.weixin.qq.com open.weixin.qq.com mp.weixin.qq.com  wx.qlogo.cn  wifi.weixin.qq.com api.
支付宝手机网站支付接入详细教程
热门推荐
中年闰土的博客
10-20 23万+
支付宝手机网站支付接入详细教程
支付开发(七)----支付宝开发之手机网站支付(H5支付)
fendo
05-02 1万+
其实官方的文档中:https://docs.open.alipay.com/203 介绍的已经很详细了，我就实地的看文档操作了一遍，具体步骤如下:一、创建应用流程如下:首先要有支付宝开放平台: https://open.alipay.com/platform/home.htm  账号，然后登录网站，创建一个应用输入应用名称，然后点击创建，详细请查看支付宝官方的介绍:https://doc.open...
银联手机支付收银台商户接入技术指南
"中国银联手机支付收银台业务商户技术...这份指南是商户成功接入和运营银联手机支付收银台业务的重要技术文档，它涵盖了从基础理论到实际操作的所有关键环节，有助于商户快速集成这一支付工具，提升其在线支付体验。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值