文档中心 > 网银支付(已下线)

接入与使用规则

更新时间:2015/10/21 访问次数:27331

类型

规范点

原因

业务操作

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

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

说明:

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

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

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

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

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

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

会影响同一笔交易的支付

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

注意:

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

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

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

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

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

便于做支付渠道区分

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

说明:

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

保护买家账户安全

平级分润规则

平级分润格式:

收款方Email_1^金额1^备注1|收款方Email_2^金额2^备注2

功能效果:

买家付出了交易金额100元,同时,金额1给了收款方Email_1,金额2给了收款方Email_2,seller_email获得剩下的金额(剩下的金额为:100-金额1-金额2-支付宝手续费)。

金额计算规则:

  • 买家交易金额=金额1+金额2+seller_email收款金额+支付宝手续费
  • 收款方Email_1实际获得金额=金额1
  • 收款方Email_2实际获得金额=金额2
  • seller_email实际获得金额=买家交易金额-金额1-金额2-支付宝手续费

分润规则,避免出现分润错误。

多级分润规则

多级分润格式:

收款方Email_1^金额1^备注1|收款方Email_1^收款方Email_2^金额2^备注2

功能效果:

买家付出了交易金额100元,同时,金额1给了收款方Email_1,收款方Email_1把获得的金额中的金额2给了收款方Email_2,seller_email获得剩下的金额(剩下的金额可以为:100-金额1-支付宝手续费)。

金额计算规则:

  • 买家交易金额=金额1+seller_email收款金额+支付宝手续费
  • 收款方Email_1实际获得金额=金额1-金额2(金额1必须大于等于金额2)
  • 收款方Email_2实际获得金额=金额2
  • seller_email实际获得金额=买家交易金额-金额1-支付宝手续费

分润规则,避免出现分润错误。

业务应用注意事项

如果商户签约的是纯网关,那么必须配置请求参数paymethod为bankPay,defaultbank为某家银行简码。

如果没有设置这两个请求参数,那么支付宝就不会按照纯网关的手续费来收取,而是按照即时到账接口收取费用,导致商户多支出费用。

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

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

当商户开通了纯网关时,使用请求参数defaultbank(默认网银)后,用户付款时支付宝会自动略过网银选择界面。

纯网关功能有自己的网银简码列表,具体请参考接口技术文档。

不同功能使用不同的网银简码才能达到网银前置的效果

一般情况下,异步通知比同步通知慢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
返回
顶部