支付宝支付开发——当面付条码支付和扫码支付实例

本文介绍支付宝中当面付下属的条码支付、扫码支付、订单查询、退款申请的集成开发过程。

本文分为以下五个部分：

条码支付和扫码支付介绍
申请应用
密钥生成及配置
api及sdk集成
条码支付、扫码支付、订单查询、退款申请

一、条码支付及二维码支付介绍

1. 条码支付
条码支付是支付宝给到线下传统行业的一种收款方式。商家使用扫码枪等条码识别设备扫描用户支付宝钱包上的条码/二维码，完成收款。用户仅需出示付款码，所有收款操作由商家端完成。其使用场景如下：
业务流程：

使用步骤：

用户登陆支付宝钱包，点击首页“付款”，进入付款码界面；
收银员在商家收银系统操作生成订单，用户确认支付金额；
用户出示钱包的“付款码”，收银员用扫码设备来扫描用户手机上的条码/二维码后，商家收银系统提交支付；
付款成功后商家收银系统会拿到支付成功或者失败的结果。

2. 扫码支付

扫码支付，指用户打开支付宝钱包中的“扫一扫”功能，扫描商家展示在某收银场景下的二维码并进行支付的模式。该模式适用于线下实体店支付、面对面支付等场景。

其使用场景如下：
业务流程：

使用步骤：

用户登陆支付宝钱包，点击首页“付款-扫码付”，进入扫一扫界面；
收银员在商家收银系统操作生成支付宝订单，用户确认支付金额，并生成二维码；
用户使用钱包的“扫码付”，扫收银员提供的二维码，确认支付；
用户付款后商家收银系统会拿到支付成功或者失败的结果。

二、接口申请

企业在申请企业支付宝之后，进行功能申请并签约，然后在蚂蚁金服开放平台中申请应用如下（详细过程就略了）
然后在功能列表中，申请当面付这一功能，申请成功后如下。
这样，我们就有了当面付的权限了。

三、密钥生成

在支付宝当面付的接口中，使用了非对称加密算法，商户自己的公钥和私钥需要自己使用openssl手动生成。对这些概念比较陌生的话，请先自行先了解一下密码学的相关知识。openssl也可以从方倍工作室博客中找到。

下载支付宝官方提供的密钥生成工具openssl，然后执行以下命令就可以生成公钥和私钥。
其中

1	`genrsa -out rsa_private_key.pem 1024`

是用于生成rsa私钥，执行后在程序目录中生成一个文件rsa_private_key.pem，其内容如下

—–begin rsa private key—–
miicxaibaakbgqcyffrongd8q/1krh1cpssri360dxlhi7zxdpjgye5hkdwf7u9b
3zzu9erzpm90xe7gzrksxigourh4uqhmvrbto3e+liyoynpd6as3q427kctit7aj
hhicz6gwhegtuivlqiuwlsauqcbi6do4gezrlvadzus0wcjijoxw02rxsqidaqab
aogaxbjyyvac4zj3jph8yostlr5n13bwdatdw/glwwt+0rnnei90tqhrnvy7lnvn
jgrprts182tvgjopxmwsnebakhiugidpq99gle4lgd5lkwtzkd84bmvhatfnsccz
cevfqkg3tzd4t3fq93frilsnnzplhiw53jirstckr3rx9oecqqdwmshyc91hevmq
qvnasbgeickwxhodqjdm2lhkbx4mrb9jezfds6mxwdajf2/qw+tgtpn3ybccdw/h
nghhqtstakea1vtyjodawwode8x4fu0ipq9+e19mcvoajjlbh46mropwgodj3raq
t/thakeaydjabstaiy2j18hitiyh+1bgjqjbakgrjxh5ofxsg7uxibcofyjifi34
g7ecfxxvcqxaaw4u4n2uy0c0txkl5t+lxzeqg8d/gfbjj0qutvnzgdofdoecqbhy
ozncfk6xe8pguxquht4jg/iu4djwjt+kuzbsjerhtcvyly4jpzfuohrkom4fj6/4
uuqwrjmabfgzrx4+sfkcqcni8rcz6yprh5keoepo3uazalnenp8dkkhgqchawdk7
7nzlj727nt23sthfx6nkhzyrujgq5vx1lkl0wkukbxm=
—–end rsa private key—–

命令

1	`rsa -in rsa_private_key.pem -pubout -out rsa_public_key.pem`

是用于生成rsa公钥，执行后在程序目录中生成一个文件rsa_public_key.pem，其内容如下

—–begin public key—–
migfma0gcsqgsib3dqebaquaa4gnadcbiqkbgqcyffrongd8q/1krh1cpssri360
dxlhi7zxdpjgye5hkdwf7u9b3zzu9erzpm90xe7gzrksxigourh4uqhmvrbto3e+
liyoynpd6as3q427kctit7ajhhicz6gwhegtuivlqiuwlsauqcbi6do4gezrlvad
zus0wcjijoxw02rxsqidaqab
—–end public key—–

生成的这个rsa公钥，需要填写到应用中去，填写地址如下所示。私钥不需要填到配置中，到时候配置到代码中。
特别注意，密钥要去掉注释部分，且转换成一行字符，否则回车换行也成为密钥的一部分，将导致无法正常加解密。
同时，可以点击 “查看支付宝公钥”，将支付宝的公钥复制保存下来，后面的程序中将需要用到。

四、密钥生成api与密钥配置
公共参数

请求地址：

环境	https请求地址
正式环境	https://openapi.alipay.com/gateway.do

公共请求参数：

参数	类型	是否必填	最大长度	描述
app_id	string	是	32	支付宝分配给开发者的应用id
method	string	是	128	接口名称
format	string	否	40	仅支持json
charset	string	是	10	请求使用的编码格式，如utf-8,gbk,gb2312等
sign_type	string	是	10	商户生成签名字符串所使用的签名算法类型，目前支持rsa
sign	string	是	256	商户请求参数的签名串，详见签名
timestamp	string	是	19	发送请求的时间，格式"yyyy-mm-dd hh:mm:ss"
version	string	是	3	调用的接口版本，固定为：1.0
notify_url	string	否	256	支付宝服务器主动通知商户服务器里指定的页面http/https路径。
app_auth_token	string	否	40	详见应用授权概述
biz_content	string	是	–	请求参数的集合，最大长度不限，除公共参数外所有请求参数都必须放在这个参数中传递，具体参照各产品快速接入文档

请求参数

参数	类型	是否必填	最大长度	描述
out_trade_no	string	必须	64	商户订单号,64个字符以内、可包含字母、数字、下划线；需保证在商户端不重复
scene	string	必须	32	支付场景条码支付，取值：bar_code 声波支付，取值：wave_code
auth_code	string	必须	32	支付授权码
seller_id	string	可选	28	如果该值为空，则默认为商户签约账号对应的支付宝用户id
total_amount	price	可选	11	订单总金额，单位为元，
discountable_amount	price	可选	11	参与优惠计算的金额，单位为元
undiscountable_amount	price	可选	11	不参与优惠计算的金额，单位为元
subject	string	必须	256	订单标题
body	string	可选	128	订单描述
goods_detail	goodsdetail []	可选	–	订单包含的商品列表信息，json格式，其它说明详见商品明细说明
operator_id	string	可选	28	商户操作员编号
store_id	string	可选	32	商户门店编号
terminal_id	string	可选	32	商户机具终端编号
alipay_store_id	string	可选	32	支付宝的店铺编号
extend_params	extendparams	可选	–	业务扩展参数
timeout_express	string	可选	6	该笔订单允许的最晚付款时间，逾期将关闭交易。
royalty_info	royaltyinfo	可选	–	描述分账信息，json格式，其它说明详见分账说明
sub_merchant	submerchant	可选	–	二级商户信息,当前只对特殊银行机构特定场景下使用此字段

公共响应参数

参数	类型	是否必填	最大长度	描述
code	string	是	–	网关返回码,详见文档
msg	string	是	–	网关返回码描述,详见文档
sub_code	string	否	–	业务返回码,详见文档
sub_msg	string	否	–	业务返回码描述,详见文档
sign	string	是	–	签名,详见文档

响应参数

参数	类型	是否必填	最大长度	描述
trade_no	string	必填	64	支付宝交易号
out_trade_no	string	必填	64	商户订单号
buyer_logon_id	string	必填	100	买家支付宝账号
total_amount	price	必填	11	交易金额
receipt_amount	string	必填	11	实收金额
buyer_pay_amount	price	选填	11	买家付款的金额
point_amount	price	选填	11	使用积分宝付款的金额
invoice_amount	price	选填	11	交易中可给用户开具发票的金额
gmt_payment	date	必填	32	交易支付时间
fund_bill_list	tradefundbill []	必填	–	交易支付使用的资金渠道
card_balance	price	选填	11	支付宝卡余额
store_name	string	选填	512	发生支付交易的商户门店名称
buyer_user_id	string	必填	28	买家在支付宝的用户id
discount_goods_detail	string	必填	–	本次交易支付所使用的单品券优惠的商品优惠信息