开发者社区
社区提问意见反馈
开发者钉组织
扫描二维码
加入支付宝开发者钉组织
文档中心
开发文档(v3版) 
支付
当面付
接入指南
api 列表
app 支付
手机网站支付
电脑网站支付
商家扣款
刷脸付
预授权支付
jsapi 支付
私域
公域
营销
资金
会员
信用
安全
广告
小程序云
其他
api文档 > 支付 > 当面付 > 常见问题
文档更新记录 >
收藏
订阅更新
我的文档
设置
当面付
q:没有门店可以申请开通当面付吗?
a:申请开通当面付是必须具备门店条件,因为当面付是一款为了满足商户在线下完成交易收款的产品。
q:开通当面付店铺招牌/内景照的标准是什么?
a:开通当面付需要有线下实体门店或店铺,商家可参考以下场景,按照要求提供相关门头照片,实际审核结果请按照页面审核情况为准。
店铺招牌:
1、门店场景:门店招牌 门面 经营物品,招牌名称完整可辨认且有完整门框,招牌内容清晰。 2、摊位场景:经营场所实景(摊位需全景 经营物品)。 3、办公场景:招牌 经营场所实景(招牌名称完整可辨认且包含营业场所内景-如办公地,经营设备)。 4、自助售卖机:完整的自助售卖机场景照片。 5、流动经营场景:经营工具全景,出租车必须有车牌号且完整。 6、团餐场景:食堂内景照。 7、停车场景:岗位亭。
内景照:
1、店铺内景照片需真实、完整、正向地进行拍摄,保证清晰、无水印、不反向、不修图 、非偷拍、非对屏幕翻拍等。 2、门店无禁限售相关内容 ,需要与营业执照经营范围相匹配。
付款码支付
q: 付款码支付是否需要输入密码?
a:在一般情况下,付款码支付主流程是代扣流程,即不需要输入密码,商家用扫码枪扫一下支付宝客户端的付款码,即可完成支付。当扣款额度超过(单笔 1000 元,单日 50000)时,接口返回错误码 acq.user_paying,需用户在支付宝钱包输入支付密码支付。
q: 什么时候需输入密码(验密支付)?
a:付款码支付请求 api 返回支付处理中(返回码 10003)时,此时若用户手机支付宝在线则会唤起手机支付宝的快捷收银台,用户可输入密码支付。商家需要在设定的轮询时间内,通过订单查询 api 查询订单状态,若返回付款成功,则表示支付成功。
q: 什么时候会唤起支付宝客户端收银台?
a:唤起手机支付宝收银台的主要场景如下:
1用户付款码的安全校验没有通过。
2支付额度超过了代扣的额度(单笔 1000 元,单日 50000)。
3代扣失败(用户的余额、用于代扣的银行卡等所有渠道都余额不足)。
q: 为什么关掉小额免密功能后,付款码支付时仍不需输入密码?
a:这是因为小额免密与付款码支付非同一概念,小额免密支付是指跳转收银台时经判断无需验证支付密码即可实现支付。支付宝客户端 9.0 版本之后,在代扣额度内默认不需要输入密码。
q: 付款码支付的离线代扣扣款次序?
a:扣款次序依次为:商家优惠券 > 账户优惠 > 天猫点券 > 红包 > 集分宝 > 会员卡 > 资金类支付工具。其中资金类支付工具的扣款次序依次为:信用卡快捷 > 信用卡卡通 > 余额 > 借记卡快捷 > 借记卡卡通 > 余额宝。如果用户自己在支付宝客户端中调整了付款方式的顺序,以用户自定义顺序为准。
q: 付款码支付安全吗?
a:支付宝采用高强度安全技术以保护付款码数据的安全性:1分钟自动刷新一次;付款码用过一次后,无论成功、失败都不能再次使用。如支付失败,需用户刷新付款码后才能再次重新发出支付请求。
q: 什么是订单支付超时?
a:即超过支付有效期尚未支付的订单将自动关闭。由于发起付款码支付请求后,需预留足够的时间供用户打开手机支付宝进行支付,故应设置比较合理的订单支付超时时间,一般通过手机支付宝支付会在 30 分钟内完成。订单支付超时时间对应的接口参数是:timeout_express,默认时间为北京时间,若未传入该参数值,则保持默认值即 3小时。
q: 如何处理未知错误或者系统异常?
a:需要调用查询接口确认订单状态或者调用退款接口发起撤销。
q: 余额不足导致扣款失败,重新充值后是否会自动扣款?
a:不会,买家账户充值后,商户需重新调用接口扣款。
撤销交易问题
q: 撤销交易的时效是多久?
a:商家可以通过交易撤销接口 alipay.trade.cancel 撤销交易,撤销交易的时效为 24 小时。处于创建状态的订单,在 24 小时内撤销后,这笔交易会被自动关闭;处于支付成功状态的订单,在 24 小时内撤销后,这笔交易会自动进行退款。
q: 退款接口、关闭接口和撤销接口的区别?
接口名
统一收单交易退款接口(alipay.trade.refund
统一收单交易关闭接口(alipay.trade.close
统一收单交易撤销接口(alipay.trade.cancel
使用权限
退款接口和关闭接口是辅助接口,只要有任意一支付产品(当面付、电脑网站支付、手机网站支付和 app 支付)权限即可调用。
统一收单交易撤销接口(alipay.trade.cancel)只有签约当面付权限才可调用的辅助接口,否则报错“isv无权限”。
适用场景
交易退款接口必须是在交易成功(交易状态处于trade_success),才可以进行订单退款。
收款的钱会原路返回到付款方的账号上。
交易关闭接口是用于交易创建后(交易状态处于wait_buyer_pay),客户在一定时间内未进行支付,对订单进行关闭。
适用于交易创建后,用户支付信息不确认,交易状态不明确,支付交易返回失败或支付系统超时,调用撤销交易。
如果此订单用户支付失败,支付宝系统会将此订单关闭。
如果用户支付成功,支付宝系统会将此订单资金退还给用户。
注意:只有发生支付系统超时或者支付结果未知时可调用撤销,其它正常支付的单如需实现相同功能请调用申请退款api。提交支付交易后调用【查询订单api】,没有明确的支付结果再调用【撤销订单api】。
调用后交易状态
退款分为全额退款和部分退款。
(1)全额退款:交易状态变为teade_close。
(2)部分退款:交易状态仍处于trade_success。
调用交易关闭接口后,交易状态变为teade_close。
调用交易撤销接口后,交易状态变为teade_close。
调用时间限制
交易有效退款时间内(即交易状态从trade_success变为trade_finished的时间)。
当面付默认3个月。
手机网站支付、电脑网站支付、app 支付默认12个月。
交易关闭时间:
当面付默认3小时。
手机网站支付、电脑网站支付、app 支付默认15天。
如果要控制交易关闭时间,除了交易关闭接口,可通过
timeout_express等超时参数控制。
交易撤销接口限制时间为1天,即交易创建后(交易状态处于wait_buyer_pay)的24小时内支持调用撤销接口,过了24小时,该接口无法再使用。
退款问题
q: 为什么退款没有立即到账?
a:退款资金一般会按原路返回。但若是通过银行卡支付,因银行结算系统限制,退款时需将该笔资金冻结在支付宝账号内,待银行结算时才能退款到银行卡,通常需要2小时。
q: 如果交易失败,但用户的银行卡扣款成功,资金如何处理?
a:若出现该情况,支付宝会在2小时内将款项退回给用户。
q: 如何确认退款状态,判断是否退款成功?
a:支付宝退款为同步退款,在退款状态不明确情况下,保证请求号相同情况下可直接发起重试,直到成功。
q: 为什么会出现无故退款的情况?
a:请确认是否调用了撤销接口,在交易成功的情况下,撤销接口的调用会发生退款。
q: 如何实现部分退款?
a:在原退款请求参数中,新增传入外部请求号 out_request_no 参数,在退款金额 refund_amount 中传入需要部分退款的金额。
q: 可退款期限是多久?
a:根据签约协议确定退款时间,一般为 12 个月。
q: 能否通过传参的形式自助设置支付可退款的期限?
a:不能。
q: 退款的到账时间是多久?
a:退款到余额为实时到账,退款到银行卡以银行实际到账时间为准。
q: 支付 2.0 接口和支付 1.0 接口能否交叉使用?
a:可以,但不推荐。
q:交易退款接口是否会触发异步通知
a:统一收单交易退款接口(alipay.trade.refund)本身接口不支持设置notify_url参数,因此退款导致触发的异步通知是发送到支付接口中设置的notify_url。
根据退款的行为可分为全额退款和部分退款,由于 app 支付异步触发条件默认trade_success(交易成功),trade_closed(交易关闭),trade_finished(交易完成)三种状态均会触发异步通知。
全额退款:交易状态变为trade_closed(交易关闭),触发通知。
部分退款:交易状态为trade_success(交易成功),触发通知。
同理可用于交易关闭接口(alipay.trade.close),接口调用后交易状态为trade_closed(交易关闭)。
q:如何区分支付和退款触发的通知?
a:相较支付触发的异步通知,退款触发异步通知中有refund_fee(总退款金额)、gmt_refund(交易退款时间)等参数。
q:如何区分全额退款和部分退款触发的通知?
a:
1异步通知中的out_biz_no为退款接口的out_request_no,若未设置则为退款的trade_no,可用于判断对应那笔退款请求。
2部分退款的交易状态是trade_success(交易成功),且异步通知中有退款相关参数等信息。
3全额退款成功的交易状态是trade_closed(交易关闭),异步通知中有退款相关参数,且含有gmt_close(订单结束时间)。
q:如何区分全额退款和订单超时触发的异步?
a:全额退款和订单超时都会导致trade_closed(交易关闭),由于全额退款是支付成功后退款导致。
全额退款的异步通知中有refund_fee(总退款金额)、gmt_refund(交易退款时间)参数,订单超时关闭没有这两个参数。
q:如何查询退款资金到账时间?
a:
1如果付款是通过支付宝余额等渠道,退款成功后就直接到账。
2如果付款是通过银行卡支付,可根据退款接口中deposit_back_info(银行卡冲退信息)的est_bank_receipt_time(预估银行到账时间)进行判断。
查询接口
q:查询接口如何查询手续费?
a:无法查询,只能通过 查看。查询接口返回的receipt_amount(实收金额)是本笔交易,商户账户能够实际收到的金额,手续费是支付宝另外扣取的费用。
q:支付成功,但查询交易返回支付金额为0?
a:查询接口中需设置query_options=fund_bill_list,才可在响应参数中返回fund_bill_list(交易支付使用的资金渠道)以及其它实付金额等信息。
示例:
q:如何区分超时付款关闭和全额退款关闭?
a:
1未付款交易超时关闭:用户未支付导致交易关闭,没有交易退款金额等信息,trade_status=trade_close。
2全额退款关闭:用户支付完成后全额退款成功,含有send_pay_date(本次交易打款给卖家的时间)等信息,trade_status=trade_close。
q:如何区分全额退款和部分退款?
a:
1部分退款:只退还部分金额,买家的交易仍然处于trade_success(交易成功)状态,含有支付金额等信息。
2全额退款:全额退款成功的交易状态是trade_closed(交易关闭),支付金额等信息为0。
注意:查询接口中必须设置query_options=fund_bill_list。
支付宝客户端账单
q:账单上的信息如何修改?
a:用户侧账单如下:

页面信息
支付账单
退款账单
头像
为b.alipay.com-的商家logo
退款账单头像固定,为一个“退”字,无法修改。
账户名称
(显示优先级)的门店名称>>商家账户认证名称。
注意:三方调用则显示授权商家信息。
退款账单显示的商家账户名称与支付账单时商家的名称一致。
无法另外设置与支付账单名称不同的信息。
金额
支付接口设置的total_amount(订单总金额)
退款接口设置的refund_amount(退款金额)
交易状态
根据交易情况返回trade_status(交易状态)。
全额退款后,支付账单显示为“交易关闭”。
退款成功显示固定格式:退款成功
商品说明
支付接口设置的subject(订单标题)
注意:“查看购物详情”目前暂不支持配置。
格式固定:退款-支付接口中设置的subject(订单标题)。
退款账单中的商品说明无法通过退款接口的refund_reason(退款原因)进行修改。
创建时间
订单创建时间,非接口请求时间。
退款接口返回的gmt_refund_pay(退款支付时间),非接口请求时间。
订单号
支付接口订单创建后生成的trade_no(支付宝交易号)支付账单保持一致。
支付账单和退款账单信息保持一致。
商户订单号
支付接口商家自定义的out_trade_no(商家订单号)。
支付账单和退款账单信息保持一致。
账单分类
根据商家自己开通产品行业分类,无法修改。
注意:支付接口设置 body(商品描述)和退款接口设置 refund_reason(退款原因)可在 或者下载的对账单中显示。

内容没有解决您的问题?您还可以前往 或 寻求帮助
凯发k8官方网娱乐官方 copyright © 支付宝(杭州)信息技术有限公司  | icp证浙b2-20160559
该文档对你是否有帮助?
当前页面目录
网站地图