注意:以下文档只适用于TOP接口,请谨慎使用!

文档中心 > 即时到账

接入与使用规则

更新时间:2016/03/03 访问次数:54443

类型

规范点

原因

业务操作

接口支持重复调用,前提是交易基本信息(买家、卖家、交易金额、超时时间等)在多次调用中保持一致,且交易尚未完成支付。

防止重复付款以及交易信息被篡改

说明:

  • 如果发现买家不一致、卖家不一致或交易金额不一致,系统会报错不能继续支付;
  • 如果超时时间不一致,则交易状态为等待买家支付,但买家支付时系统会报错。

即时到账的优势:快捷,不存在卖家发货、买家确认收货的操作,直接将买家的资金转入卖家的支付宝账号。

即时到账交易主要用于虚拟物品和不存在卖家发货、买家确认收货的交易场景,比如手机话费交易、游戏币充值、网上订餐类网站等。

填写买家支付宝账号时,不能与卖家的支付宝账号相同。

避免报错,如错误码:BUYER_SELLER_EQUAL。

即时到账交易不允许卖家在交易创建后修改价格

会影响同一笔交易的支付

支付宝每一次退款成功,都会向商户的即时到账异步通知地址notify_url发送一条交易成功的通知,其中状态有refund_status、refund_success。

注意:

  • 商户要注意做防订单重复更新的代码处理。
  • 交易关闭的状态不会发送通知,因此当进行全额退款操作时,会出现收不到通知的情况,而在部分退款操作时,能收到即时到账接口的交易通知。
    解决方案是:
    商户使用退款接口,把退款的商户业务逻辑程序写到退款接口的通知页面里去,而即时到账接口中不对退款的通知做任何判断。

如果不处理或者处理错误会将商户自己的业务逻辑执行2次以上

如果商户的一笔交易在退款期限内,没有进行退款操作,则支付宝系统会默认将交易的状态改为“交易完成”(即不可退款模式),并主动发送一条交易状态为trade_finished的异步通知(可以联系支付宝关闭发送),商户需要根据通知,结合自身业务逻辑做交易不可退款的数据库状态变更。

处理错误会导致商户业务逻辑重复2次付款成功

本接口支持的众多支付通道中,储蓄卡支付和信用卡支付一旦进入网银系统页面,支付宝将无法控制订单的支付效率问题。

便于做支付渠道区分

如果想要买家不安装数字证书也能进行余额支付,商户需要申请开通非证书余额支付功能;否则,买家必须申请安装数字证书才能用支付宝余额支付。

说明:

该种情况只有在买家从来没有申请过数字证书的情况下才有效。

保护买家账户安全

业务应用注意事项

站内不能关闭交易,只能通过站外接口关闭交易。可通过自定义超时参数实现控制交易关闭时间。

交易订单自定义超时关闭功能

一般情况下,异步通知比同步通知慢3秒左右。但在网络环境、服务器处理速度等因素影响下,有时异步通知会比同步通知快一些,所以商户需要使用数据库数据锁防止订单重复更新。

即时到账异步通知与同步通知时间

支付宝支付手续费扣取模式分为两种:

  • 实时扣费模式:一般都是收款账户扣费,或采用合同指定固定扣款支付宝账户扣费;
  • 月结手续费模式:实时交易不扣手续费,月底账单统一结算。

实时扣费时,在扣费支付宝账号的账务明细中可马上查到扣费记录;但月结模式下,则不会查到。

如果商户请求时传递了extra_common_param参数,支付宝会在同步和异步通知中返回该参数。

支持商户自定义公用回传参数(extra_common_param)

建议商户不要使用类似js的window.open、location.replace等没有访问记录的重定向函数跳转到支付网关,强烈建议使用form表单提交数据。

规范代码使用规则及减少弹出控件拦截支付(导致支付成功率下降)

在集成接口的过程中,如果商户使用seller_email作为收款账户,则当需要修改该支付宝账号登录名时,商户必须在程序中做相应修改,否则在支付过程中会出现卖家账户不存在的错误。推荐使用seller_id做为商户收款账户。

seller_id值是支付宝分配给商户的唯一身份ID,不会改变,使用seller_id作为收款账户可以避免seller_email变更导致商户无法收款的问题。(可在集成时联系支付宝技术支持获取seller_id值。)

卖家发起退款操作后,买家是通过什么渠道付款的,则款项原路退回。比如,买家用的是支付宝账号余额付款,则钱退回到支付宝账号;借记卡付款,则退回借记卡;信用卡付款,则退回信用卡。

说明:

  • 如果用户付款的银行卡注销了,则钱退回到支付宝账号;
  • 如果用户没有支付宝账号,商户签约了充退转账功能,则商户可进行充退转账操作给用户退款;商户未签约充退转账功能,则需要联系支付宝进行退款。

买家通过何种渠道付款,则款项原路退回。

FAQ

关于此文档暂时还没有FAQ
返回
顶部