一、文档地址
官方文档地址:[url]https://docs.open.alipay.com/20180417160701241302[/url]
二、开发前准备工作
1、签约:[url]https://openclub.alipay.com/read.php?tid=276&fid=72[/url]
2、创建应用:[url]https://openclub.alipay.com/read.php?tid=1606&fid=72[/url]
3、生成密钥:[url]https://openclub.alipay.com/read.php?tid=1833&fid=69[/url]
4、下载服务端sdk:[url]https://docs.open.alipay.com/54/106370/[/url]
注意事项:1、不支持沙箱测试;2、需签约并添加功能;3、支持第三方调用。
检查调用appid的应用功能列表中是否添加“支付宝预授权”。
三、接口集成流程
1、各接口注意事项
1.线上资金授权冻结(alipay.fund.auth.order.app.freeze)
2.授权转支付(alipay.trade.pay )
{"code":"40004","msg":"Business Failed","sub_code":"ACQ.INVALID_PARAMETER","sub_msg":"参数无效","buyer_pay_amount":"0.00","invoice_amount":"0.00","point_amount":"0.00","receipt_amount":"0.00"}
{"code":"40004","msg":"Business Failed","sub_code":"ACQ.INVALID_PARAMETER","sub_msg":"参数无效:买家不能为空","buyer_pay_amount":"0.00","invoice_amount":"0.00","point_amount":"0.00","receipt_amount":"0.00"}
{"alipay_trade_refund_response":{"code":"40004","msg":"Business Failed","sub_code":"ACQ.TRADE_NOT_EXIST","sub_msg":"交易不存在","refund_fee":"0.00","send_back_fee":"0.00"}
3.资金授权解冻(alipay.fund.auth.order.unfreeze)
{"alipay_fund_auth_order_unfreeze_response":{"code":"20000","msg":"Service Currently Unavailable","sub_code":"aop.SYSTEM_ERROR","sub_msg":"系统错误"},
3.资金授权撤销(alipay.fund.auth.operation.cancel)
{"alipay_fund_auth_operation_cancel_response":{"code":"40004","msg":"Business Failed","sub_code":"ORDER_ALREADY_FINISH","sub_msg":"授权订单已经完结,无法再进行资金操作"}
2、demo示例
Java示例及demo:[url]https://openclub.alipay.com/read.php?tid=11412&fid=59[/url]
php示例及demo:[url]https://openclub.alipay.com/read.php?tid=11697&fid=60[/url]
.net示例及demo:[url]https://openclub.alipay.com/read.php?tid=11699&fid=60[/url]
四、注意事项
1.确认是否已签约,详细的请参考:[url]https://openclub.alipay.com/read.php?tid=11745&fid=72[/url]
2.如果想要使用芝麻免押功能,在默认的签约中是没有的需要商户主动邮件申请开通,主动申请开通【信用授权】,可主动发送至zmxyservice@zmxy.com.cn申请开通【信用授权】 邮件内容包含商户名称,PID,商户的行业 产品名。
3.支付宝预授权如何配置授权免押额度:[url]https://openclub.alipay.com/read.php?tid=11419&fid=72[/url]
五、常见接口报错
支付宝预授权接口报错系统异常自查方案:[url]https://openclub.alipay.com/read.php?tid=11411&fid=60[/url]
1.Q:线上资金授权冻结接口报错系统繁忙、系统异常
A:这个报错一般是参数或是秘钥问题,详细的排查方案请参考:[url]https://openclub.alipay.com/read.php?tid=11411&fid=60[/url]
2、Q:为什么无法使用花呗进行付款冻结?
A:使用花呗需要商户签约有花呗支付的渠道且拥有花呗准入的(可联系商户客服确认是否满足这些条件:联系商户客服电话:0571-88158090,或在线商户客服:[url]https://cschannel.alipay.com/newPortal.htm?scene=mysjbzzx[/url])
3、Q:为什么有的用户无法使用芝麻免押?
A:商家必须要有芝麻免押渠道,首先必须芝麻分不低于配置的限定分值才能免押,其次如果该用户之前有逾期违规行为导致列入芝麻风控,行业黑名单,芝麻分足够也有可能无法免押的,是否准入根据芝麻平台风控判断为准,(如果无法使用免押可以咨询芝麻客服进行确认:客服电话:0571-88158055 转 2 在线咨询:[url]https://b.xin.xin/ant/product/index.htm[/url] )
4、Q:如何使用银行卡进行付款冻结?
A:如果不限制渠道支付的话不传入enable_pay_channels参数,这样就可以选择使用银行卡进行付款冻结
5、Q:关于冻结接口生成订单的机制
A: 创建支付宝订单的机制是唤起支付宝收银台,比如A用户的支付宝钱包唤起了收银台,这时候B用户在使用A用户的URL去唤起收银台会报系统异常,或者参数无效。在唤起的时候就会根据支付宝客户端进行绑定订单
6、Q:关于冻结接口超时参数的问题pay_timeout
A:这个参数是控制订单超时的时间,不传默认是15M,这个不传指的是整个参数不传,而不是传入空值,超过15M后会再次进行付款冻结会出现两个报错,一个是系统异常,一个是订单参数异常
7、Q:关于调用冻结接口未安装支付宝钱包的问题导致的报错
A:这个是基于在支付宝客户端进行的,如果未安装支付宝钱包H5支付冻结是走不通的(不像日常使用的支付接口在未检测到支付宝客户端会转入到H5页面进行登入),会提示用户去安装支付宝钱包