文档中心 > 批量付款到支付宝账户

接入与使用规则

更新时间:2015/10/28 访问次数:62933

类型

规范点

原因

业务操作

同一个批次号只允许提交一次,切勿重复提交或更名再次提交。

防止支付宝系统在处理时当作不同批次而重复处理,导致商户重复付款。

批次提交成功,仅代表批次提交成功,不代表支付宝处理完成。

避免造成商户对提交了的批次做错误处理

如果商户有设置通知路径,那么在商户的通知批次中无需做签名验证,仅需对notify_id做校验即可,也就是只需验证是否是支付宝发来的请求。

支付宝发起的通知没有参数sign

付款的账号必须支付宝账号余额充足

付款账户余额不足,请在当天24点前充值以确保执行,晚于24点将自动废弃。

付款的账号必须与支付宝账号保持一致

避免打款失败的情况

有密接口需要支付密码,且需要安装付款用户的证书。

避免打款失败的情况

批量付款完成后,收款人不是实时收到钱。一般需要过5~10分钟后到账。

为了保障资金的正确性和安全性,打款时间会有所延长。

付款明细格式

detail_data的值中不能有“^”、“|”等影响detail_data格式的特殊字符。

避免文件上传校验不通过,上传失败。

商户流水号:

支持填写任意数字(必须小于等于22个字符)且必须唯一。

填写不正确会导致整个批次失败

收款方支付宝账号与收款方的真实姓名需要匹配

如果填写不正确,将不能打款到指定的用户账户中。

收、付款方支付宝账号必须都要通过实名认证。

如果未做实名认证则会导致此笔明细打款失败

备注:备注不能超过50个汉字(100个字节)。

如果超过长度,会将备注设置为N/A,用户查询结果时将看不到原始的备注信息。

总金额:

  • 以“元”为单位,精确到两位小数;
  • 必须与付款明细中所有流水的金额的总和相等。

总金额填写不正确会导致整个批次失败

总笔数:

  • 一个批次最多1000笔;
  • 必须与付款明细中所有流水的笔数总和相等。

总笔数填写不正确会导致整个批次失败

支付宝账号(email):

商户的支付宝账号,支持邮箱、手机号码格式。

支付宝账户必须是真实存在的,否则会导致整个批次失败。

付款限额

默认情况下,单笔打款金额小于50万。

如果大于约定的限额,此笔明细将会做失败处理。

默认情况下,每个批次金额小于1000万。

如果大于约定的限额,此批次将会做失败处理。

付款方和收款方都是对公账户,且通过实名认证的单笔金额小于200万。

如果大于约定的限额,此笔明细将会做失败处理。

网络

确保网络顺畅

防止批次提交不成功

使用间隔时间

多笔批次提交时,每笔批次提交的间隔时间建议在5分钟~10分钟左右。

批次频繁提交可能会导致商户不能及时拿到处理结果

接口异常

 

提交批次中如果出现异常情况,请使用批量付款到支付宝账户状态查询接口(btn_status_query)进行查询,确认付款批次是否提交成功。

避免批次重复提交,导致商户重复付款。

如果用“批量付款到支付宝账户状态查询接口(btn_status_query)”查询到批次或明细状态为P(处理中)(如:付款时账户余额不足)时,请在第二天再次使用查询接口查询,来确认该批次是作废还是成功,以便做后续的业务处理。

当批次或明细为P(处理中)状态时,支付宝会平均以8分钟/次的频率进行重试处理,直到当日24:00后停止。如果还未处理成功,则P状态会自动转变为F(失败)。

FAQ

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