风控审核未通过 快速接入示例 Demo
1 接入前常见问题1.1 Q:对接芝麻免押前需要准备的工作有哪些?
A:在对接芝麻免押前的准备工作参考接入指引:芝麻免押接入准备 。
1.2 Q:目前芝麻免押是收费的还是免费的/收费标准是什么?
A:目前免押为收费产品,收费标准参考文档: 。
1.3 Q:已开放的行业方案和本公司经营行业不太贴合,如何处理?
A:相关行业陆续持续开放中,若有未涉及到的行业方案,可加入钉钉群联系商务运营咨询(群号 )。
1.4 Q:信用服务配置信息审核未通过,如何处理?
A:审核失败的原因以及如何进行调整,可联系芝麻客服核实。芝麻信用客服电话 - 转 2,服务时间为工作日 9:00-18:00。
1.5 Q:部分免押场景具体怎么理解?
A:
1.6 Q:商家调用规范常见问题有哪些?
A:开发者调用预授权转支付接口时,若扣款失败,千万不要更换 ,否则会生成新的履约单,导致用户信用账异常。
正确的做法是:使用最初的 继续扣款,直到成功为止。
系统检测到一些商家,一笔预授权订单,生成了成千上万笔履约单,非常影响系统效率。对于此类问题,支付宝会限期整改,若未及时纠正,将终止芝麻信用服务。
详细说明可查看 信用预授权商家调用规范。
1.7 Q:商户必须保存数据有哪些?
A:
接口名称
接口
必存数据
创建免押订单
.fund.auth.order.app.
发起扣款
.trade.pay
2 接入中-下单常见问题2.1 Q:创建免押订单时,提示买家认证不通过无法继续交易需要怎么处理?
A:这种情况是由于买家并未在支付宝进行实名认证因此无法使用该产品,需买家实名认证之后重试。
2.2 Q:用户无法使用免押问题如何排查?
A:目前用户无法使用免押的情况比较复杂,可以优先从以下两个方面进行自助排查,如果排查后依然找不到原因可联系技术支持帮忙处理。
首先,需要排查商户当月的冻结额度、当日的冻结额度是否用完,可以在 信用服务管理页 查看,如果没有展示则说明并未对商家的当月的冻结额度、当日的冻结额度进行限制,需要进行第二步排查。
可能为验收拦截,具体参考:芝麻免押自助验收指南。查询用户是否因为信用评估不通过而无法使用免押。使用商家支付宝账户登录 ,使用 用户支付宝 UID 或 外部订单号 进行查询。
2.3 Q:用户开通的时候风控咨询不通过,如何排查具体原因?
A:请使用商家支付宝账户登录 ,使用 支付宝 UID 或 外部订单号 进行查询。
注意:只能查询本 PID 名下的订单,按照创建时间显示近 50 条数据。
2.4 Q:用户由于风控问题无法使用免押,如何排查具体原因?
A:请使用商家支付宝账户登录 ,使用 支付宝 UID 或 外部订单号 进行查询。
注意:只能查询本 PID 名下的订单,按照创建时间显示近 50 条数据。
2.5 Q:用户芝麻分满足为什么无法使用免押?
A:目前芝麻风控不仅仅基于芝麻分进行评估,还有其他维度的数据用于风控评估以保障商户资产。如商家配置的限笔(最大租用笔数),限额有关(当前分数最大免押额度),免押风控判断条件有很多,可以看下后台风控配置的准入门槛介绍。
2.6 Q:小程序下单为什么总是提醒交易风险?
A:当下单提示存在交易风险时说明支付宝安全中心判断该商户/交易存在一定风险,具体原因商户可以联系支付宝商户客服咨询解决,商户客服电话:。
2.7 Q:用户实际免押金额为什么会大于配置的风控金额?
A:目前芝麻免押场景中存在租押分离能力,在风控评估的时候使用的商家传入的评估金额。具体参考:芝麻免押支持租押分离 。
2.8 Q:用户创建了免押订单但是没有签约/授权,是否需要调用解冻接口进行解冻?
A:不需要,只有冻结成功的订单才需要执行后续的业务逻辑,商户可以通过接口查询订单状态:查询免押订单 。
2.9 Q:调用 .fund.auth.order.app. (创建芝麻免押订单)返回为空怎么处理?
A:目前.fund.auth.order.app. (创建芝麻免押订单)返回的内容主要是为了拉起冻结页面;因此只要该接口返回了加签串内容即为成功。
2.10 Q:调用 .fund.auth.order.app. (创建芝麻免押订单)如何获取拉起签约页的url?
A:通过调用 .fund.auth.order.app. 返回的 body 内容即为加签字符串。
2.11 Q:芝麻免押下单成功的异步通知/回调为什么一直通知?
A:接收到异步通知后正常执行业务逻辑后,需要主动输出 内容后便不会重复通知。
2.12 Q:芝麻免押下单如何设置异步通知地址?
A:商户需要在下单/扣款请求体中设置异步通知地址,具体设置方式如下:
2.13 Q:芝麻免押下单的时候是否可以指定扣款渠道/传入?
A:芝麻免押在下单阶段使用的是信用资产,没有办法指定扣款渠道。可以在扣款阶段指定扣款渠道。
2.14 Q:前端运行在A支付宝账号小程序,后端用B支付账号创建免押,用户是否能正常根据sign进行跳转?
A:B账号服务端生成的冻结链接,A可以使用对应的小程序唤起免押页面的。
2.15 Q:小程序端调用下单接口返回的结果拉起页面弹出付款失败,订单不存在或状态异常是什么原因?
A:下单接口扩展参数 里的参数需转化成json格式,并且使用支付宝开发者工具小程序测试会导致出现异常,要使用真机测试。
3 接入中-扣款常见问题3.1 Q:芝麻免押扣款为什么会失败?
A:由于芝麻免押冻结的为用户信用额度,在扣款接口需要从用户的多种支付渠道扣减实际的资金,所以会存在用户余额不足、没有可用支付工具等原因操作扣款失败,这种情况下需要商户进行主动重试。
3.2 Q:芝麻免押扣款如何设置异步通知地址?
A:商户需要在下单/扣款请求体中设置异步通知地址,具体设置方式如下:
3.3 Q:用户通过其它渠道支付了订单后应该做什么操作?
A:
情景一,订单金额 100 元,商户发起扣款 10 元,用户通过其它渠道支付了 10 元,此时商户应调用 取消扣款 接口取消此前发起的交易。
情景二,订单金额 100 元,商户发起扣款 10 元,用户通过其它渠道支付了 10 元,若商户不需要再扣钱,此时需要调用 解冻芝麻免押订单 接口解冻全额 100 元。若商户认为用户已守约,可在 解冻芝麻免押订单 接口扩展参数传入 =true ,此时用户信用记录将变成已守约。
3.4 Q:使用芝麻免押的时候如何实现按照一定周期自动扣用户租金?
A:目前芝麻免押没有提供系统级别的周期扣款能力,但是商户可以在用户进行信用下单之后自行设置周期调用 发起扣款 接口实现周期扣款逻辑;但是这里需要注意的是只有上一期扣款成功后才能发起新的一期扣款,在扣款成功之前商户可以使用原扣款单号进行重试或者先关单重新发起扣款重试。
3.5 Q:芝麻免押用户下单成功后,每个月可以自动扣用户的租金吗?
A:用户开通后商户可以按照自己的业务逻辑周期调用.trade.pay(统一收单交易支付接口)实现周期扣款逻辑;但是这里需要注意的是只有上一期扣款成功后才能发起新的一期扣款,在扣款成功之前商户可以使用原扣款单号进行重试或者先关单重新发起扣款重试。
3.6 Q:芝麻免押用户下单成功后,是否可以让用户主动按期还款?
A:不可以,目前用户下单成功后,需要商户按照自己的业务规则主动调用交易进行扣费。
3.7 Q:免押订单扣款的时候如果商户通过线下收款或个人转账收到了钱,是否需要调用关闭接口把对应扣款失败的订单关闭?是否需要解冻全部的冻结金额?
A:可以主动关闭对应扣款失败的订单,需要解冻剩余的冻结金额,否则用户的信用记录会展示一条未完结的守约记录,造成用户客诉。
3.8 Q:芝麻免押用户下单成功后,是否需要商户主动调用支付接口?
A:需要,目前用户下单成功后,需要商户按照自己的业务规则主动调用交易进行扣费。
3.9 Q:芝麻免押用户下单成功后,订单超过360天还能扣款么?
A:不行,目前芝麻免押的订单有效期为360天,超过后会自动进行解冻。
3.10 Q:.trade.pay如何使用指定扣款渠道/传入?
A:目前,在芝麻免押场景中,该参数并不是标准开放参数。但是如果商户有诉求仍然可以中传入该参数进行使用。目前支持的渠道说明: 。
3.11 Q:存在在途的扣款是否还能发起新的交易订单?
A:不可以,目前基于用户体验考虑只允许商户有一笔在途扣款的交易订单,如果已经存在一笔在途的扣款订单,再次发起一笔新的会报错拦截。
3.12 Q:芝麻免押订单转交易时指定扣了款渠道/传入了但是依然走了其他扣款渠道,为什么?
A:这种情况一般是传参存在问题,如多了空格之类的,具体格式参考: 。
3.13 Q:.trade.pay接口返回没有可用的支付工具?
A:这个错误码的含义是在对用户进行扣款的时候,该用户的支付宝中并没有可用的扣款渠道(如:用户绑定的银行卡失效、关闭了余额支付等都会导致该错误)。
3.14 Q:在芝麻免押部分信用部分资金的情况下扣款/解冻的顺序是什么?
A:在部分信用免押的场景中,扣款/解冻优先使用资金进行操作。
3.15 Q:在芝麻免押扣款失败提示授权单已完成如何处理?
A:这种情况下是由于该笔授权单据已经完结无法再进行扣款所致,可以通过 接口获取订单最新状态。
3.16 Q:在芝麻免押扣款的时候如果接口同步返回扣款失败,是否还需要关闭交易单?
A:如果扣款接口明确返回扣款失败的时候,是没有生效交易订单的所以不需要主动关闭。但是这里有一个因为网络超时导致没有拿到返回结果的情况,还需要通过交易异步通知/使用原请求内容(外部请求号+扣款金额等信息保持一致)发起扣款来确认是否已经创建交易。
3.17 Q:在使用芝麻免押进行预授权的时候是否需要进行解冻?
A:需要进行解冻的,否则用户的信用记录页会一直展示一条未完结的信用记录造成客诉。商户可以在最后一次发起扣款时传入解冻标识,也可以单独调用完结接口进行处理。
3.18 Q:芝麻免押订单授权冻结金额扣完后是都需要主动解冻?
A:不需要,在订单金额全部扣完后会自动解冻。
3.19 Q:芝麻免押订单扣款如果用户账户没钱怎么办?
A:扣款后会有一个期限,如果在这个期限内扣不到款,就会变为逾期状态,然后影响用户的芝麻信用。
3.20 Q:一笔芝麻免押的扣款逾期支付,原扣款是否可以继续支付?还是需要重新发起扣款才可以?
A:原订单参数重新发起扣款,超过14天原流水号还可继续发起扣款,扣款成功就变为完结状态。
3.21 Q:调用转支付接口后,根据返回的结果就可以确定扣款成功了吗?
A:不建议使用同步结果确定。要等回调通知才能确定扣款成功;有的时候会出现10003等待用户支付的情况(一般是用户银行卡过多,轮询扣款还未结束,支付宝同步返回了结果),需要主动查询或者监听异步消息来判断是否扣款成功。
3.22 Q:支付时没有可用的支付工具导致无法支付怎么处理?
A:用户配置的扣款渠道中余额不足,支付失败后导致的,需要用户补充余额才能完成扣款。
3.23 Q:转支付时是否需要上一笔扣款时效/完成后才能发起新的扣款?
A:是的,目前基于用户体验考虑只允许商户有一笔在途扣款的交易订单,如果已经存在一笔在途的扣款订单,再次发起一笔新的会报错拦截。
4 接入中-验收常见问题4.1 Q:接入芝麻免押时如何进行验收?
A:参考验收文档:芝麻免押自助验收指南 。
4.2 Q:芝麻免押验收规范是什么?
A:参考验收文档:芝麻免押自助验收指南 。
4.3 Q:芝麻免押验收的时候输入的授权单号如何获取?
A:在用户使用芝麻免押下单后,会通知商户相关的授权单号,商户需要保留用于后续的扣款、完结等操作,该参数参考: 。
芝麻免押自助验收指南 。
4.4 Q:芝麻免押验收的时候,报租物场景不能为空怎么处理?
A:商户需要在下单时按照规范传入和内容,具体参考: 。
4.5 Q:芝麻免押验收的时候,服务归属商户验收失败为什么?
A:商户需要传入信用服务id对应的商户id,以2088开头的16位字符串。
4.6 Q:芝麻免押验收的时候,交易关闭无法通过怎么处理?
A:这个case是为了模拟扣不到用户钱的时候需要先关闭在途交易重新发起的场景,商户可以在发起扣款的时候可以通过 指定扣款渠道来模拟。
4.7 Q:芝麻免押验收的时候,如果模拟扣款失败的case?
A:商户可以在发起扣款的时候可以通过 指定扣款渠道来模拟。
4.8 Q:芝麻免押验收工具各个参数怎么填?
A:【关闭交易用例-授权单号】:授权单号是 .fund.auth.order.app.接口数据用户授权成功以后返回的 参数。
【部分扣款用例-授权单号】:同关闭交易用例-授权单号,授权单号是 .fund.auth.order.app. 接口数据用户授权成功以后返回的 参数。
【部分扣款用例-交易单号】:同关闭交易用例-交易单号,调用 .trade.pay(统一收单交易支付接口)部分扣款交易号时返回的 。
【额度解冻用例-授权单号】: 解冻授权单号是 .fund.auth.order.app. 接口数据用户授权成功以后返回的 参数。
5 免押高阶产品能力常见问题5.1 Q:芝麻免押升级后,租押分离/续租必过/专业版能力l3等级是否可以直接接入?
A:目前,芝麻免押租押分离/续租必过/专业版等能力通过商家等级实现了开放,可以在 芝麻免押页面 查看当前等级。
商家可以参考以下文档进行评估是否可以使用:
5.2 Q:想要使用芝麻免押租押分离/续租必过/专业版能力是否还需要独立申请?
A:目前,芝麻免押租押分离/续租必过/专业版等能力通过商家等级实现了开放,可以在 芝麻免押页面 查看当前等级。
商家可以参考以下文档进行评估是否可以使用:
5.3 Q:如何确认芝麻免押租押分离/续租必过/专业版能力是否可以使用?
A:目前,芝麻免押租押分离/续租必过/专业版等能力通过商家等级实现了开放,可以在 芝麻免押页面 查看当前等级。
商家可以参考以下文档进行评估是否可以使用:
5.4 Q:芝麻免押下单后,如何确定是否走了专业版的逻辑?
A:可以根据订单查询接口返回结果中的 进行判断。参考:。
5.5 Q:芝麻免押下单后,查询异步风控数据返回是什么原因?
A:这种情况是非信用订单,只有信用预授权单才允许查询异步风控数据。
6 其他问题
本章节主要为不属于上述分类的问题。
6.1 Q:芝麻免押订单的失效/授权是一年的嘛?超过一年是否会自动解冻?
A:目前芝麻免押订单默认是1年有效,超过有效期自动解冻。具体还需要以商户签约的协议为准。
6.2 Q:是否可以提供查询芝麻分/信用分接口来判断是否可以提供服务?
A:基于数据安全考虑,目前并不会直接向商户透出用户的芝麻分信息。
6.3 Q:用户授权免押后,是否可以通过接口查询用户芝麻分?
A:由于数据安全问题,目前并不提供直接查询用户芝麻分的接口。
6.4 Q:订单什么时候会逾期?
A:具体逾期时间可查看 全场景逾期时间说明 。
6.5 Q:单笔免押金额配置后是否可能降低的情况?
A:目前免押金额为商户在芝麻信用当前测算的规则内进行配置,并不会被随意修改。
6.6 Q:如何查询用户是否有免押请求?
A:由于数据安全目前芝麻信用侧并不会提供查询用户是否有免押请求的工具,需要商户自己记录用户在商户侧的操作信息。
6.7 Q:解冻用户订单后,为什么会存在用户感知到的解冻金额与实际解冻金额不符的情况?
A:由于芝麻免押可以使用部分信用资产+部分用户资金组合的冻结方式,因此在解冻的时候也会分别解冻剩余的信用资产+用户资金,所以造成了用户感知到的入账金额与实际解冻金额不符的情况,具体详情可以查看账单页的关联交易信息。
6.8 Q:免押订单已经同步履约为什么用户还是展示逾期?
A:这个是由于商家历史发起过多次扣款,其中有的扣款订单没有及时关闭导致的用户展示逾期的状态,商户可以通过我们提供的 工具来处理。
6.9 Q:信用不免押能做信用冻结吗?
A:信用不免押无法做信用冻结,同时不会产生信用记录。
6.10 Q:转支付退款失败,是什么原因?
A:转支付订单超时 3 个月自动结束,需保证订单在 3 个月内完成扣款才可以走接口退款。
6.11 Q:芝麻免押和JSAPI支付的回调地址可以设置为同一个吗?什么参数可以区分开呢?
A:可以设置为同一个, 两个产品的产品码不一样的。
6.12 Q:PHP语言开发生成私钥后需要转换吗?
A:平台配置的是应用公钥,PHP需要格式转换,代码中传入转换后的私钥。
6.13 Q:芝麻免押的页面是否可以自己修改?
A:目前不支持修改。需要按照支付宝侧的规则进行入参,目前支持的样式包括:只扣押金、下单时租金已知、下单时租金未知,参考 芝麻免押开通受理台模式 。
6.14 Q:请求解冻金额超限是什么原因?
A:请检查解冻或撤销接口设置的金额是否大于当前交易冻结的金额;如果是,请更改解冻或撤销接口设置的金额,重新发起请求。
6.15 Q:免押失败怎么处理?
A:这种情况是用户芝麻信用综合评估未通过,暂时无法提供免押服务。
6.16 Q:免押分层限制规则,商户维度单日扣款金额上限,扣款失败的也会算进去吗?
A:是的,只要发起扣款了就计算进去,具体链接:免押等级。