支付宝当面付（条码支付）功能开发

最新推荐文章于 2023-02-01 14:31:27 发布
最新推荐文章于 2023-02-01 14:31:27 发布
阅读量5.3k 收藏 5
点赞数 2
分类专栏： 移动支付

1、什么是当面付


商户可通过以下任一方式在线下完成交易收款：
  • 商家通过扫描线下买家支付宝钱包中的条码、二维码等方式将买家的交易资金直接打入卖家支付宝账户，资金实时到账；
  • 线下买家通过使用支付宝钱包扫描商家的二维码等方式完成支付，提升商家收银效率，资金实时到账；
  • 线下买家使用支付宝钱包中的当面付功能，通过声波支付的方式向商家完成付款，资金实时到账。

简单地说，即我们日常中使用的 条码支付、扫码支付、声波支付。

本篇的开发流程，将以条码支付为功能开发展开说明， 条码支付即用户展示付款条码，商家设定金额后采用扫码枪（或输入用户条码值）扫描用户条码，直接进行扣款，所有操作由商家完成，用户仅需提供条码。


2、条码支付业务说明



使用步骤很简单：
  • 用户登录支付宝钱包，在首页点击“付款”，进入付款码界面
  • 收银员在商家收银系统操作生成订单
  • 用户出示其“付款码”，收银员用扫码设备扫描用户手机上的条码（或手动输入条码值）后，商家收银系统提交支付
  • 付款后支付宝后台会返回支付结果给商家，同时将支付情况通知到用户




3、如何接入条码支付

官方接入文档说明： 当面付快速接入

3.1 创建应用和配置

3.1.1 创建应用

登陆支付宝开放平台，找到 “ 开发者中心 - 应用 - 创建应用 ”：
 
创建应用后，选择支付应用，因为是自己开发自己用，所以选择自用型应用，名称自定义：
 

3.1.2 填写资料和提交审核

功能选项中需要签约开通“当面付”，提交一些审核资料什么的，此处不展开。
 
这部分的说明在官方有详细文档《 开放平台应用创建指南》，此处仅对 “开发配置” 作重点说明：
3.1.2.1 应用网关 和 授权回调地址
  • 应用网关，用于接收支付宝异步通知（比如用户付款成功了的通知会发送到该地址，口碑开店的门店信息修改也会触发通知）
  • 授权回调地址，即第三方授权或用户信息授权后回调地址

这两项是 非必需填写项，根据实际情况来是否配置。

3.1.2.2 应用密钥RSA2
密钥的生成在官方有文档说明《 如何生成密钥》：

注意：其中密钥长度为1024的即为RSA（SHA1），长度为2048的即为RSA2（SHA256）

3.1.2.3 提交审核
各项设置完成后，提交审核，审核预计在一个工作日完成，审核完成后，应用状态会显示为“已上线”。
 
（注意：应用命名不能出现如支付字样，于是之前我的应用因为名字“猛追湾一卡通条码支付”被驳回审核了，手动微笑）


3.2 条码支付开发

先看下官方提供的接口调用流程：
时序图

显然，如上所示，涉及三个接口：

接口调用涉及一大堆参数， 支付宝倒是也很贴心，直接帮我们做好了相关的SDK（ 服务端SDK ），可以直接调用API，而且对于一些公共参与已经帮我们封装好了，调用时只需要传入业务参数即可。

下载好SDK之后，里面的readme也写的很明白，集成支付宝接口需要引入的文件是：
  • alipay-sdk-java*.jar
  • commons-logging-1.1.1.jar

在《 服务端SDK》中有调用示例如下： 
   
   
  1. //实例化客户端
  2. AlipayClient alipayClient = new DefaultAlipayClient("https://openapi.alipay.com/gateway.do", APP_ID, APP_PRIVATE_KEY, "json", CHARSET, ALIPAY_PUBLIC_KEY, "RSA2");
  3. //实例化具体API对应的request类,类名称和接口名称对应,当前调用接口名称：alipay.open.public.template.message.industry.modify 
  4. AlipayOpenPublicTemplateMessageIndustryModifyRequest request = new AlipayOpenPublicTemplateMessageIndustryModifyRequest();
  5. //SDK已经封装掉了公共参数，这里只需要传入业务参数
  6. //此次只是参数展示，未进行字符串转义，实际情况下请转义
  7. request.setBizContent("  {" +
  8. "    \"primary_industry_name\":\"IT科技/IT软件与服务\"," +
  9. "    \"primary_industry_code\":\"10001/20102\"," +
  10. "    \"secondary_industry_code\":\"10001/20102\"," +
  11. "    \"secondary_industry_name\":\"IT科技/IT软件与服务\"" +
  12. " }");
  13. AlipayOpenPublicTemplateMessageIndustryModifyResponse response = alipayClient.execute(request); 
  14. //调用成功，则处理业务逻辑
  15. if(response.isSuccess()){
  16.     //.....
  17. }

显然因为SDK封装得很友好，我们只需要传入配置参数，设置好业务内容参数，直接调起方法就可以了。下面是我个人的代码示例：

为了方便将来配置参数的修改，配置直接写到了配置文件中： 
   
   
  1. #应用id，要求应用上线，且其下功能签约状态为生效
  2. appId=20110906...78327
  4. #应用私钥（appId所属应用的应用私钥）RSA2加密方式
  5. privateKey=MIIEvgI...oC6/I2xPqZnvhbntS5qi1NwYg2
  7. #支付宝公钥
  8. alipayPublicKey=MIIBI...wIDAQAB

然后做一个类来进行封装开发者配置，用一个类来封装业务参数的JSON，再封装一个工具类以使用。

封装开发者配置的类： 
   
   
  1. import java.io.IOException;
  2. import java.io.InputStream;
  3. import java.util.Properties;
  5. /**
  6.  * 支付宝API类
  7.  */
  8. public class AlipayAPI {
  9.     /** 应用ID */
  10.     private static String appId;
  11.     /** 应用私钥 */
  12.     private static String privateKey;
  13.     /** 支付宝公钥 */
  14.     private static String alipayPublicKey;
  16.     /** 支付调用接口 */
  17.     private static final String url_pay = "https://openapi.alipay.com/gateway.do";
  19.     static {
  20.         InputStream is = AlipayAPI.class.getResourceAsStream("/alipay.properties");
  21.         Properties prop = new Properties();
  22.         try {
  23.             prop.load(is);
  24.             setAppId(prop.getProperty("appId"));
  25.             setPrivateKey(prop.getProperty("privateKey"));
  26.             setAlipayPublicKey(prop.getProperty("alipayPublicKey"));
  27.             
  28.         } catch (IOException e) {
  29.             e.printStackTrace();
  30.         }
  31.     }
  33.     public static String getAppId() {
  34.         return appId;
  35.     }
  37.     public static void setAppId(String appId) {
  38.         AlipayAPI.appId = appId;
  39.     }
  41.     public static String getPrivateKey() {
  42.         return privateKey;
  43.     }
  45.     public static void setPrivateKey(String privateKey) {
  46.         AlipayAPI.privateKey = privateKey;
  47.     }
  49.     public static String getAlipayPublicKey() {
  50.         return alipayPublicKey;
  51.     }
  53.     public static void setAlipayPublicKey(String alipayPublicKey) {
  54.         AlipayAPI.alipayPublicKey = alipayPublicKey;
  55.     }
  57.     public static String getUrl_pay() {
  58.         return url_pay;
  59.     }
  61. }

封装业务请求参数的类（注意，此处示例仅有部分必要参数，更多参数详见 官方文档的请求参数部分）： 
   
   
  1. /**
  2.  * 统一收单交易支付的参数封装类
  3.  */
  4. public class PayParam {
  5.     /** 商户订单 */
  6.     private String out_trade_no;
  7.     /** 支付场景 */
  8.     private String scene;
  9.     /** 支付授权码，即用户的付款码 */
  10.     private String auth_code;
  11.     /** 订单标题 */
  12.     private String subject;
  13.     /** 订单金额 */
  14.     private double total_amount;
  16.     public PayParam(String out_trade_no, String subject, double total_amount, String auth_code) {
  17.         this.out_trade_no = out_trade_no;
  18.         this.subject = subject;
  19.         this.total_amount = total_amount;
  20.         this.auth_code = auth_code;
  21.     }
  23.     public String getOut_trade_no() {
  24.         return out_trade_no;
  25.     }
  27.     public void setOut_trade_no(String out_trade_no) {
  28.         this.out_trade_no = out_trade_no;
  29.     }
  31.     public String getScene() {
  32.         return scene;
  33.     }
  35.     public void setScene(String scene) {
  36.         this.scene = scene;
  37.     }
  39.     public String getAuth_code() {
  40.         return auth_code;
  41.     }
  43.     public void setAuth_code(String auth_code) {
  44.         this.auth_code = auth_code;
  45.     }
  47.     public String getSubject() {
  48.         return subject;
  49.     }
  51.     public void setSubject(String subject) {
  52.         this.subject = subject;
  53.     }
  55.     public double getTotal_amount() {
  56.         return total_amount;
  57.     }
  59.     public void setTotal_amount(double total_amount) {
  60.         this.total_amount = total_amount;
  61.     }
  62. }

支付工具类和测试代码： 
   
   
  1. import com.alibaba.fastjson.JSON;
  2. import com.alipay.api.AlipayApiException;
  3. import com.alipay.api.AlipayClient;
  4. import com.alipay.api.DefaultAlipayClient;
  5. import com.alipay.api.request.AlipayTradePayRequest;
  6. import com.alipay.api.response.AlipayTradePayResponse;
  8. import java.util.Date;
  10. /**
  11.  * 支付宝的工具类
  12.  */
  13. public class AlipayUtil {
  14.     /** UTF8编码格式 */
  15.     private static final String CHARSET_UTF8 = "UTF-8";
  16.     /** 加密方式 */
  17.     private static final String SIGN_TYPE = "RSA2";
  18.     /** 数据格式 */
  19.     private static final String FORMAT = "JSON";
  20.     /** 支付场景，条码支付 */
  21.     private static final String SCENE_BARCODE = "bar_code";
  23.     /**
  24.      * 当面付（条码支付）
  25.      * @param content
  26.      * @return
  27.      */
  28.     public static AlipayTradePayResponse barCodePay(PayParam content){
  29.         AlipayClient client = new DefaultAlipayClient(AlipayAPI.getUrl_pay(), AlipayAPI.getAppId(),
  30.                 AlipayAPI.getPrivateKey(), FORMAT, CHARSET_UTF8, AlipayAPI.getAlipayPublicKey(), SIGN_TYPE);
  32.         AlipayTradePayRequest request = new AlipayTradePayRequest();
  33.         content.setScene(SCENE_BARCODE);
  34.         String bizContent = JSON.toJSONString(content);
  35.         request.setBizContent(bizContent);
  37.         AlipayTradePayResponse response = null;
  38.         try {
  39.             response = client.execute(request);
  40.         } catch (AlipayApiException e) {
  41.             e.printStackTrace();
  42.         }
  43.         return response;
  44.     }
  46.     /**
  47.      * 支付完成后的业务处理
  48.      * @param response
  49.      */
  50.     public static void afterBarCodePay(AlipayTradePayResponse response) {
  51.         if (response.isSuccess()) {
  52.             //处理业务逻辑
  53.             System.out.println("start handle business");
  54.         }
  55.     }
  57.     /**
  58.      * 获取商户订单
  59.      * @return
  60.      */
  61.     public static String getTradeNo() {
  62.         return "PAY" + new Date().getTime();
  63.     }
  66.     //测试
  67.     public static void main(String[] args) {
  68.         String tradeNo = getTradeNo();
  69.         String subject = "测试用订单";
  70.         double totalAmount = 0.01;
  71.         String authCode = "274726044141298157";
  73.         PayParam param = new PayParam(tradeNo, subject, totalAmount, authCode);
  74.         AlipayTradePayResponse response = barCodePay(param);
  75.         System.out.println(response.getBody());
  76.         afterBarCodePay(response);
  77.     }
  79. }

因为SDK封装的缘故，所以整体过程很简单了，对于支付成功后的响应，以及其他支付查询、支付退款等功能就不再展开了。

但是自己在过程中还是有两个点觉得有点坑，再次提一下：
  • 创建AlipayClient对象的传参中，公钥是支付宝公钥，而不是应用公钥
  • 服务端SDK的示例中请求调用的类是AlipayOpenPublicTemplateMessageIndustryModifyResponse，实际条码支付的请求类应该调用AlipayTradePayRequest


4、参考链接

乘着风筝去旅行
关注
专栏目录
单笔转账到支付宝账户java_php实现单笔转账到支付宝功能
weixin_42584507的博客
02-28 256
本文实例为大家分享了php实现单笔转账到支付宝的具体代码，供大家参考，具体内容如下1.首先 去蚂蚁金服签约 单笔转账到支付宝2.需要的配置信息1).应用appid2).生成密钥根据文档步骤生成上传这里的 应用公钥3.下载官方sdk 然后集成到自己项目官方实例//实例化客户端AlipayClient alipayClient = new DefaultAlipayClient("https://op...
支付宝 当面付（扫描支付） 对接逻辑
qq_34285557的博客
05-08 7971
支付宝 当面付（扫描支付） 对接逻辑 这两天给网站 博客下方添加了 打赏功能 使用的是 支付宝的 当面付功能 特此记录一下，觉得不错的可以在下方打赏 嘿嘿 ，下面先来看一下效果图。 1.当面付产品介绍 支付宝当面付产品官网介绍 本篇主要介绍 扫码支付 当面付帮助商家在线下消费场景中实现快速收款，支持 条码支付 和 扫码支付 两种付款方式。商家可通过以下两种任一方式进行收款，提升收银效率，实现资金实时到账 条码支付：买家出示支付宝钱包中的条码、二维码，商家扫描用户条码即可完成 条码支付
支付宝扫码付和条形码付款demo（java）
02-09
支付宝扫码付和条形码付款demo（java）
支付宝 下单 查询 扫码 支付
03-21
VC MFC C++ C VS2005 支付宝 下单 查询 扫码 支付
支付宝支付开发——当面付条码支付和扫码支付实例
10-21
支付宝支付开发涉及的主要内容是当面付条码支付和扫...总的来说，支付宝当面付的条码支付和扫码支付提供了便捷的支付体验，开发者需要熟悉支付宝提供的API和SDK，以及相关的安全措施，才能顺利集成到自己的应用程序中。
python实现支付宝当面付（扫码支付）功能
09-20
在深入探讨如何使用Python实现支付宝当面付（扫码支付）功能之前，首先需要明确当面付和扫码支付的概念。当面付是指消费者在商户处通过扫描商户生成的二维码来进行支付，而扫码支付通常指消费者使用手机扫描商户的...
支付宝当面付PHP示例
12-24
支付宝当面付，也称为“条码支付”，是支付宝提供的一种线下支付服务，适用于商家与消费者面对面交易的场景。PHP作为流行的服务器端脚本语言，常用于开发Web应用，包括集成支付宝接口。在这个PHP示例中，我们将深入...
支付宝当面付实例-在线乞讨-在线要饭源码
01-05
【支付宝当面付实例】是支付宝提供的一种便捷的线下支付方式，它允许商家通过扫描用户手机上的二维码或者条形码来完成交易。这种方式无需网络连接，简化了支付流程，提高了支付效率，尤其适用于实体店铺或者临时性的...
支付宝面对面支付（境内）
oyy的博客
01-30 6394
1、面对面支付分为扫码支付PreCreatePay（用户扫商家生成的二维码）和条码支付BarCodePay（商家扫用户二维码） 2、文件名：AlipayNotify.jsp(信息回调接收页面)、BarCodePay.html/jsp(条码支付)、PreCreatePay.html/jsp(扫码支付)、Query.html/jsp(查询交易信息)、Refund.html/jsp(交易退款)、Can
码支付V1.0.zip_kitchencpn_qq支付互扫_打赏_支付码_码支付源码
07-15
支持微信、支付宝、QQ钱包的扫码支付，可以用作打赏赞助支付的网站系统，支持后台查看实时收入情况，系统完全开源，无后门，直接上传自己服务器进行安装即可！
支付宝服务端API的详细参数说明《Alipay Easy SDK API Doc》
最新发布
XuDream的博客
02-01 2780
对于Alipay Easy SDK尚未支持的Open API，开发者可以通过调用此方法，通过自行拼装请求参数，完成大部分OpenAPI的调用，且调用时可按需设置所有可选参数。本接口同样会自动为您完成请求的加签和响应的验签工作。ISV对接当面付产品需涉及返佣时，请先阅读。查看更加详细的参数说明。查看更加详细的参数说明。查看更加详细的参数说明。查看更加详细的参数说明。查看更加详细的参数说明。查看更加详细的参数说明。查看更加详细的参数说明。查看更加详细的参数说明。查看更加详细的参数说明。查看更加详细的参数说明。
支付宝支付开发——当面付条码支付和扫码支付
weixin_34124577的博客
08-26 822
关键字：支付宝 当面付 条码支付 扫码支付 二维码支付 订单查询 退款作者：方倍工作室原文:http://www.cnblogs.com/txw1958/p/alipay-f2fpay.html 本文介绍支付宝中当面付下属的条码支付、扫码支付、订单查询、退款申请的集成开发过程。 本文分为以下五个部分： 条码支付和扫码支付介绍 申请应用 密钥...
支付宝支付接口开发———在线扫码支付
weixin_30781631的博客
08-28 526
一、所需jar包 服务端sdk下载地址：https://doc.open.alipay.com/docs/doc.htm?spm=a219a.7629140.0.0.470nRM&treeId=193&articleId=103419&docType=1 详细文档参考：蚂蚁金服开放平台文档中心，具体的api及测试demo都可以查到　地址：　https://doc....
公众号中调用支付宝支付
热门推荐
----------
05-06 1万+
文章转自：https://zuoluo11.github.io/2017/07/04/%E5%BE%AE%E4%BF%A1%E5%85%AC%E4%BC%97%E5%8F%B7%E9%9B%86%E5%90%88%E6%94%AF%E4%BB%98%E5%AE%9D%E6%94%AF%E4%BB%98/              感谢本作者API及业务逻辑手机网站支付API可以前往以下网址查看及下...
Android端集成支付宝支付
钟情短发姑娘的博客
03-08 8775
Android端集成支付宝支付1.申请账号及配置变量支付宝快速接入链接点击打开链接支付宝扫码或者账号密码登录下面是支付宝给出的接入介绍第一步：创建应用并获取APPID要在您的应用中接入支付宝App支付能力，需要通过创建应用的方式接入蚂蚁相关接口并进行开发，基于对行业及业务场景痛点的理解，创造能够满足市场需要的解决方案，以应用的形式服务用户。若还未成为开放平台的入驻服务商或者商户, 请完成入驻指引。...
支付宝生活号对接-----(三)芝麻认证
weixin_43966245的博客
05-17 3373
记录一下支付宝认证过程 如果要认证 , 必须要有身份证,和姓名 , 可以通过不同的途径获取, 也可以通过授权获取,也可以通过h5获取 参考支付宝API :https://docs.open.alipay.com/271/dz10yd 调用certification.initialize接口进行认证初始化，并获取返回值biz_no。biz_no是本次认证的标识，在后面的认证接口和查询接口会用...
Java接入支付宝支付(alipay)
JinglongSource的博客
03-21 6347
最近公司有一个需求是接入第三方支付(微信&支付宝),我接到了支付宝支付,所以本博客主要就简述我如何面像文档编程的经过，和中间遇到的小坑小洼，只要一步一步来操作，轻松接入alipay 微信支付的话,等有时间了,我向部门伙伴请教,看看套路是否差不多,到时候再写一篇关于接入微信支付的. 其实个人觉得,了解了一篇的话也一通百通了,毕竟还能差多少呢? 接入明确几点 是否满足申请条件(非常最要,...
php实现支付宝当面付（扫码支付）功能
璀璨烟花
12-16 4518
环境依赖 PHP5.0以上，且需要开启CURL服务、SSL服务。 注意事项 1.文件开头的配置信息必须完善 2.商户私钥需填写对应签名算法类型的私钥，如何生成密钥参考： 2.1 生成RSA密钥 2.2 创建应用 <?php header('Content-type:text/html; Charset=utf-8'); $appid = 'xxxxx'; //https://open...
评论 2
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值