业务操作

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

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

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

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

如果商户有设置通知路径，那么在商户的通知批次中无需做签名验证，仅需对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（失败）。