开发
API
自2022年9月6日起,本文档站不再更新内容,相关文档已迁移至全新“抖音开放平台”前往

接入指南

关键节点介绍

关键节点

说明

进件

该环节是使用支付产品的前提,进件是开通支付账户的过程,至少需要选择开通一个渠道的支付账户

支付

商户发起预下单请求,并根据预下单返回的信息获取开放平台提供的收银台页面;用户支付的款项在商户的「在途账户」中

结算及分账

当商户将履约状态同步到订单中心后,可发起结算请求,如有分账诉求,则可通过该接口将分账列表传入。此时扣除分账的资金及平台的技术服务费后,剩余资金到商户的可提现账户

退款

如果在结算前发起的退款,则从商户的「在途账户」退款,此时平台不收取技术服务费;如果在结算后发起退款,则从商户的「可提现账户」退款,平台收取的技术服务费不退还,且不会从分账方回退资金

退分账

商户发起分账后,如果发生退款,可以从已分账方退回分账到商户结算户。只支持外部分账方的退分账,不支持平台抽佣、手续费等退分账。

提现

当商户发起提现后,资金从「可提现账户」到商户的银行账户或支付渠道的余额账户,此时资金是可调配状态

获取对账单

商户可定期获取平台提供的对账单进行对账

接口清单

目录

模块名称

接口列表

描述

API列表

进件

发起进件请求

提交商户资料,开通商户号以收款或接收分账

图片上传接口

发起进件请求需要上传商户证件等图片,需要先调用图片上传接口获取image_id

进件状态查询

开发者/服务商可以通过接口主动查询进件结果

进件状态回调

将进件成功或失败的消息通知给开发者/服务商

支付

预下单接口

提交支付订单信息

唤起收银台

用预下单获取的order_id等信息唤起收银台

支付结果查询

开发者/服务商可以通过接口主动查询支付订单状态,完成下一步的业务逻辑

支付结果回调

将用户支付成功的消息通知给开发者/服务商

退款

发起退款

可通过此接口将支付款退还给用户

退款结果查询

开发者/服务商可以通过接口主动查询退款订单状态

退款结果回调

将退款成功或失败的消息通知给开发者/服务商

结算及分账

发起结算及分账

到达分账周期后,商户将交易成功的资金,结算给自己或分账给其他分账方

结算及分账结果查询

开发者/服务商可以通过接口主动查询分账订单状态

结算及分账结果回调

将整单分账结果通知给开发者/服务商

退分账

发起退分账

支付订单已经分账的情况下发生退款,可以调用此接口将已分账的资金从分账接收方的账户回退给分账方,再发起退款

查询分账回退结果

开发者/服务商可以通过接口主动查询退分账订单状态

提现

商户余额查询

查询商户各渠道账户余额

商户提现

对可提现账户余额发起提现

商户提现结果查询

开发者/服务商可以通过接口主动查询提现订单状态

商户提现回调

将提现成功、失败或退票的消息通知给开发者/服务商

获取对账单

获取对账单

开发者/服务商可以通过对账单查询接口查询支付、退款、分账、退分账的账单

接口获取页面链接

进件

开发者获取小程序收款商户/合作方进件页面

获取进件页面链接,通过页面提交商户资料,开通商户号以收款或接收分账

服务商获取小程序收款商户进件页面

获取进件页面链接,通过页面提交商户资料,开通商户号以收款或接收分账

服务商获取服务商进件页面

获取进件页面链接,通过页面提交商户资料,开通商户号以收款或接收分账

服务商获取合作方进件页面

获取进件页面链接,通过页面提交商户资料,开通商户号以收款或接收分账

提现

开发者获取小程序收款商户/合作方提现页面

获取账户余额页面链接,通过页面可查询余额及发起提现

服务商获取小程序收款商户提现页面

获取账户余额页面链接,通过页面可查询余额及发起提现

服务商获取服务商提现页面

获取账户余额页面链接,通过页面可查询余额及发起提现

服务商获取合作方提现页面

获取账户余额页面链接,通过页面可查询余额及发起提现

一、进件

1.1 进件角色

如果没有分账给合作方的诉求,则只需要收款商户进件,如果有分账诉求,则商户的合作方也需要完成进件,不同角色进件的流程和填写的信息一致。

  • 收款商户:提供商品或服务,并收取用户资金。
  • 商户合作方:如果商户有其合作方,需要将收取的资金作为佣金分一部分给到合作方(如物流公司,技术服务商等),则商户合作方也要完成进件。

如果是服务商协助小程序开发的情况,服务商需要提前完成进件,服务商自己进件成功后如得到小程序授权可代替小程序下的收款商户及商户合作方进件,不同角色进件的流程和填写的信息一致。

  • 服务商:代替收款商户接入字节开放平台的相关能力,服务商完成进件后才有资质发起支付等相关接口以及收取商户佣金。

1.2 进件方式

进件方式

使用方法

支持进件的角色

适用情况

字节小程序开发者平台

字节小程序开放平台-【某小程序】-【功能管理】-【支付】-【支付产品】页面填写信息完成进件

收款商户、商户合作方

商户无需开发,登录后台即可操作

接口进件

调用接口传入商户信息完成进件

收款商户、商户合作方、服务商

需要进件的商户数量较多,且具备技术开发能力

接口获取进件页面链接

需调用接口获取进件页面链接,打开链接后在页面上填写信息完成进件

收款商户、商户合作方、服务商

为商户搭建了其他操作后台,通过此方式将进件页面内嵌到其他后台

1.3 进件流程

进件时选择进件渠道并填写信息,字节开放平台会将进件信息提交给微信,支付宝和抖音支付,微信和支付宝内部有审核,信息确认,打款认证等环节,抖音支付需要验证开户意愿。

具体进件状态可在字节小程序开放平台或调用接口查看。

1.3.1 支付宝内部进件流程

(1)支付宝审核

支付宝内部审核进件资料,一般情况下系统审核 3 分钟内完成;

特殊行业、特殊情况需人工审核,预计将在 3 个工作日内完成,请耐心等待。

(2)商户签约

商户协议签署通知将发送到商户进件时填写的管理员邮箱或手机(短信),否则将默认通知到支付宝账号本身的绑定邮箱或手机(短信)。

手机端签署

商户收到签约通知后,使用入驻时提交的支付宝账号登录手机支付宝,参照以下步骤完成协议签约。

PC 端签署
  • 商户收到签约通知后,使用入驻时提交的支付宝账号,登录 支付宝商家中心。登录后的首页会看到提示:你有一份待确认的协议,请签署,点击 了解详情 进入消息中心。

说明:若商户登录 支付宝商家中心 未看到 待确认协议 提示,可点击右上角 📢 按钮进入 通知中心,查看待办事项。

  • 点击 待办事项 ,进入协议签署页面。
  • 根据页面提示完成协议签署。
  • 勾选 同意《支付宝服务协议》,点击 确认签约,提交签约内容。

1.3.2 微信内部进件流程

审核、签约、账户验证,为三个并行流程。

  • 审核:指微信支付审核申请单资料,3-7 个工作日完成;
  • 账户验证:指判断指定条件的商家,需通过指定方式核实开户意愿,详情可看下文。
  • 签约:指商家超级管理员,使用微信打开指定页面,核实签约。

完成上述三个环节,即完成入驻。

(1)微信审核

当申请单状态为“审核中”时,3-7 个工作日完成审核,请等待审核结果。

(2)账户验证

根据主体类型和管理员类型判断是否需要账户验证:

商户类型

管理员类型

是否需要账户验证

验证方式

小微/个人卖家

法人/经营者

无需验证,直接进入“审核中”状态

/

个体工商户 / 企业

法人/经营者

无需验证,直接进入“审核中”状态

/

负责人

需账户验证,进入“待账户验证”状态

支持以下方式二选一:

1.汇款验证:商户使用指定户名的银行账户,汇款指定金额至财付通指定银行账户,完成验证。(30天有效期)

2.法人扫码:法人微信扫码,完成验证。(需系统校验通过才支持该验证方式,30天效期)

党政、机关及事业单位 /其他组织

法人/经营者

需账户验证,进入“待账户验证”状态

汇款验证:商户使用指定户名的银行账户,汇款指定金额至财付通指定银行账户,完成验证。(30天有效期)

负责人

商户汇款后,请等待 1-2 天,具体以银行到账时间为准。汇款金额,系统会自动退款至商户的汇款银行账户。

(3)商户签约

当进件状态为“待签约”时,商户需根据指引在平台上完成签约。

需由管理员进行签约,扫码的微信号-绑定银行卡实名信息(姓名+身份证号),需与进件信息中管理员信息(姓名+身份证号)一致。

1.3.3 抖音支付内部进件流程

基于支付机构监管合规要求,抖音支付近期开启开户意愿验证

  • 通过开发者平台或接口进件抖音支付,暂时不需要意愿验证
  • 接口获取进件页面链接,需要意愿验证

(1)打款回填验证

  • 若商户填写的结算银行卡为对公卡,则系统将发起打款回填验证;

在信息填写页面点击【提交】之后,系统将对结算银行卡进行随机打款,商户在收到打款后,将金额填写至页面中,并点击【提交验证】。若打款金额和填写的收款金额吻合,则意愿验证通过。

(2)银行卡四要素验证

  • 若商户填写的结算银行卡是对私卡时,则系统将发起银行卡四要素验证。

在信息填写页面点击【提交】之后,在验证页面须输入银行卡预留手机号,并点击【获取验证码】发送短信,用户填写完短信验证码后,点击【提交验证】。若短信验证码验证及银行卡四要素验证通过,则意愿验证通过。

1.4 进件材料清单

需要说明的已通过文字说明(文字说明的必填),✓ 表示必填,× 为不需要填

进件信息

商户类型

个人

小微

个体工商户

企业

事业单位

民办非企业

社会团体

党政及国家机关

商户信息

商户简称

自定义

自定义

自定义

自定义

自定义

自定义

自定义

自定义

商户官网链接

官网或与商户相关网站地址

官网或与商户相关网站地址

官网或与商户相关网站地址

官网或与商户相关网站地址

官网或与商户相关网站地址

官网或与商户相关网站地址

官网或与商户相关网站地址

官网或与商户相关网站地址

商户所属行业

行业类型

行业类型

行业类型

行业类型

行业类型

行业类型

行业类型

行业类型

商户证件类型

个人身份证

个人身份证

营业执照(证件号码需要为18位)

营业执照(证件号码需要为18位)

事业单位法人证书

民办非企业登记证书

社会团体法人登记证书

党政机关批准设立文件/行政执法主体资格证

商户证件照片

商户证件名称

身份证姓名

身份证姓名

填写商户证件照片上的名称;
商户名称不能以“公司”结尾;
若营业执照上商户名称为空或为“无”,请填写"个体户+经营者姓名",如“个体户张三”;

填写商户证件照片上的名称;

填写商户证件照片上的名称;
商户名称不能以“公司”结尾;

填写商户证件照片上的名称;

填写商户证件照片上的名称;

填写商户证件照片上的名称;
商户名称不能以“公司”结尾;

商户证件号码

商户证件起止日期

商户证件营业地址

法定代表人信息

证件类型

身份证

身份证

抖音支付支持的证件类型:身份证、护照、港澳居民来往内地通行证、台湾同胞来往大陆通行证;
微信支持的证件类型:身份证、护照、港澳居民来往内地通行证、台湾同胞来往大陆通行证、外国人居留证、港澳居民证、台湾居民证
支付宝支持的证件类型:身份证、港澳居民来往内地通行证、台湾同胞来往大陆通行证、外国人居留证;

身份证

法人证件照片

当证件类型为护照时,不需要传背面照,只需要传入正面照即可;其他证件类型都需要传正反面。

姓名

证件号码

证件起止日期

证件登记住址

×

×

×

当所选渠道包含微信时,需要填写此项

×

×

×

×

最终受益人信息

经营者/法人是否为最终受益人

×

×

×

当所选渠道包含微信时,需要填写此项

×

×

×

×

证件类型

×

×

×

当所选渠道包含微信且经营者/法人不是最终受益所有人,则需提填写受益所有人信息

×

×

×

×

证件照片

×

×

×

当所选渠道包含微信且经营者/法人不是最终受益所有人,则需提填写受益所有人信息

×

×

×

×

姓名

×

×

×

当所选渠道包含微信且经营者/法人不是最终受益所有人,则需提填写受益所有人信息

×

×

×

×

证件号码

×

×

×

当所选渠道包含微信且经营者/法人不是最终受益所有人,则需提填写受益所有人信息

×

×

×

×

证件起止日期

×

×

×

当所选渠道包含微信且经营者/法人不是最终受益所有人,则需提填写受益所有人信息

×

×

×

×

证件登记住址

×

×

×

当所选渠道包含微信且经营者/法人不是最终受益所有人,则需提填写受益所有人信息

×

×

×

×

管理员信息

管理员类型

只能选【经营者/法人】

只能选【经营者/法人】

可选择【经营者/法人】或【经办人】

可选择【经营者/法人】或【经办人】

可选择【经营者/法人】或【经办人】

可选择【经营者/法人】或【经办人】

可选择【经营者/法人】或【经办人】

可选择【经营者/法人】或【经办人】

管理员证件类型

身份证

身份证

抖音支付支持的证件类型:身份证、护照、港澳居民来往内地通行证、台湾同胞来往大陆通行证;
微信支持的证件类型:身份证、护照、港澳居民来往内地通行证、台湾同胞来往大陆通行证、外国人居留证、港澳居民证、台湾居民证
支付宝支持的证件类型:身份证、港澳居民来往内地通行证、台湾同胞来往大陆通行证、外国人居留证;

身份证

管理员证件照片

×

×

当所选渠道包含微信且管理员为经办人时需要

当所选渠道包含微信且管理员为经办人时需要

当所选渠道包含微信且管理员为经办人时需要

当所选渠道包含微信且管理员为经办人时需要

当所选渠道包含微信且管理员为经办人时需要

当所选渠道包含微信且管理员为经办人时需要

管理员姓名

管理员证件号码

证件起止日期

×

×

当所选渠道包含微信且管理员为经办人时需要

当所选渠道包含微信且管理员为经办人时需要

当所选渠道包含微信且管理员为经办人时需要

当所选渠道包含微信且管理员为经办人时需要

当所选渠道包含微信且管理员为经办人时需要

当所选渠道包含微信且管理员为经办人时需要

业务办理授权函

×

×

当所选渠道包含微信且管理员为经办人时需要,请参照示例图打印业务办理授权函,全部信息需打印(不支持手写商户信息),并加盖公章。

当所选渠道包含微信且管理员为经办人时需要,请参照示例图打印业务办理授权函,全部信息需打印(不支持手写商户信息),并加盖公章。

当所选渠道包含微信且管理员为经办人时需要,请参照示例图打印业务办理授权函,全部信息需打印(不支持手写商户信息),并加盖公章。

当所选渠道包含微信且管理员为经办人时需要,请参照示例图打印业务办理授权函,全部信息需打印(不支持手写商户信息),并加盖公章。

当所选渠道包含微信且管理员为经办人时需要,请参照示例图打印业务办理授权函,全部信息需打印(不支持手写商户信息),并加盖公章。

当所选渠道包含微信且管理员为经办人时需要,请参照示例图打印业务办理授权函,全部信息需打印(不支持手写商户信息),并加盖公章。

管理员手机号

接收重要管理信息及日常操作验证码

接收重要管理信息及日常操作验证码

接收重要管理信息及日常操作验证码

接收重要管理信息及日常操作验证码

接收重要管理信息及日常操作验证码

接收重要管理信息及日常操作验证码

接收重要管理信息及日常操作验证码

接收重要管理信息及日常操作验证码

管理员邮箱

用于接收签约邮件及日常业务通知

用于接收签约邮件及日常业务通知

用于接收签约邮件及日常业务通知

用于接收签约邮件及日常业务通知

用于接收签约邮件及日常业务通知

用于接收签约邮件及日常业务通知

用于接收签约邮件及日常业务通知

用于接收签约邮件及日常业务通知

签约支付宝账号

当所选渠道包含支付宝时需要,用于开户过程中的协议确认,支付宝账号须完成实名且实名信息与商户名称一致
支付宝账号注册及实名流程参考:
个人 https://opendocs.alipay.com/common/02kg61
企业 https://opendocs.alipay.com/common/02kkum

结算信息

结算方式

微信/抖音支付:只支持结算到对私银行卡
支付宝:只支持结算到支付宝账户

微信/抖音支付:只支持结算到对私银行卡
支付宝:只支持结算到支付宝账户

微信/抖音支付:支持对公或对私银行卡
支付宝:支持结算到支付宝账户或对私/对公银行卡

微信/抖音支付:只支持对公银行卡
支付宝:支持结算到支付宝账户或对公银行卡

微信/抖音支付:只支持对公银行卡
支付宝:支持结算到支付宝账户或对公银行卡

微信/抖音支付:只支持对公银行卡
支付宝:支持结算到支付宝账户或对公银行卡

微信/抖音支付:只支持对公银行卡
支付宝:支持结算到支付宝账户或对公银行卡

微信/抖音支付:只支持对公银行卡
支付宝:支持结算到支付宝账户或对公银行卡

银行卡开户名

结算账户非支付宝账号时必填,支付宝账号不需要填;需要与商户名称一致

结算账户非支付宝账号时必填,支付宝账号不需要填;需要与商户名称一致

结算账户非支付宝账号时必填,支付宝账号不需要填;需要与商户名称一致

结算账户非支付宝账号时必填,支付宝账号不需要填;需要与商户名称一致

结算账户非支付宝账号时必填,支付宝账号不需要填;需要与商户名称一致

结算账户非支付宝账号时必填,支付宝账号不需要填;需要与商户名称一致

结算账户非支付宝账号时必填,支付宝账号不需要填;需要与商户名称一致

结算账户非支付宝账号时必填,支付宝账号不需要填;需要与商户名称一致

结算证明函

×

×

×

×

当所选渠道是微信,银行卡开户名可与商户名称不一致,如果不一致需要提供结算证明函

×

×

当所选渠道是微信,银行卡开户名可与商户名称不一致,如果不一致需要提供结算证明函

关系证明函

×

×

×

×

当所选渠道是微信,银行卡开户名可与商户名称不一致,如果不一致需要提供关系证明函

×

×

当所选渠道是微信,银行卡开户名可与商户名称不一致,如果不一致需要提供关系证明函

其他补充证明

×

×

×

×

当所选渠道是微信,银行卡开户名可与商户名称不一致,如果不一致请提供非同名结算的法律法规、政策通知、政府或上级部门公文等证明文件,以作上述材料的补充证明。

×

×

当所选渠道是微信,银行卡开户名可与商户名称不一致,如果不一致请提供非同名结算的法律法规、政策通知、政府或上级部门公文等证明文件,以作上述材料的补充证明。

银行名称

开户地址

开户支行名

银行卡号

微信/抖音支付必填

微信/抖音支付必填

支付宝账号

支付宝必填

支付宝必填

特殊行业补充资料

补充材料

商户所属行业为特殊行业时需要补充对应材料(点此查看特殊行业及补充材料清单

​​

1.5 进件常见问题

问题描述

原因

解决方案

【支付宝】返回:"签约失败 商户状态[清退]不满足签约要求"

触发支付宝风控规则,商家被支付宝清退过,不满足签约要求。 支付宝综合评估合作风险过高,目前已经终止合作且无法恢复;

告知商家无法完成进件,支付宝原因。 只能过了清退期或者换主体重新签约申请入驻。

账户具体的情况,可以引导账户持有人自行致电95188进入人工服务咨询

【支付宝】返回:“工商网校验失败”,

部分个体工商户营业执照名称为文字“空”,商户名称cert_name填写错误 营业执照注册时间较短,支付宝未更新数据 营业执照信息填写有误

原因1:引导商家填写商户名称(cert_name)为文字“空”

原因2:过几天再尝试

请确认下营业执照信息正确性,商家可进入工商网自行查询:http://www.gsxt.gov.cn/index.html

【支付宝】返回:“工商网校验营业执照不合法”

商家填写信息错误,例如:填写信息与营业执照不一致,或个体工商户商户名称填写为个人姓名 支付宝数据未更新导致

引导商家填写正确信息,个体工商户商户名称为营业执照上的名称

【支付宝】返回:“签约失败 限权中心:商户不符合实名制标准”

传入的支付宝账号不符合实名制标准

需要补全身份信息,补全后重新进件

支付宝账号注册及实名流程参考:

个人 https://opendocs.alipay.com/common/02kg61

企业 https://opendocs.alipay.com/common/02kkum

【支付宝】商户入驻支付宝时,系统返回“工商网效验法人信息不匹配”

商家在工商局变更过营业执照信息,且微信/支付宝和工商局信息同步可能存在延迟(约两周)

使用工商网工商网信息查询系统 ,输入营业执照编号或者商户名称进行法人信息以及营业执照信息查询。

【支付宝】返回,报错“证件号和支付宝账号的证件不匹配”

支付宝账号实名认证的身份证号和入驻填写的法人的身份证信息不一致 支付宝账号认证用的证件非大陆身份证,但入驻时选的法人类型是“身份证” 大小写不对,X应为大写

原因1:引导商户确认填写信息是否有误,若有误,商户进行修改

原因2:修改为一致的证件类型

【支付宝】审核时间长,一直处理中

商家未完成协议签署

提示管理员完成协议签署,协议会短信和邮件发送给管理员

【支付宝】申请单受理失败,返回:“已存在处理中或送审失败的订单号,请联系客服咨询”

重复进件,平台拦截

查询进件状态

【支付宝】返回:“支付宝账号不存在”

【支付宝签约账号】或【支付宝结算账号】填写不正确导致 支付宝账号填写成公司名称

引导商家确认填写信息是否有误,若有误,请商家进行修改。 注意:【支付宝签约账号】或【支付宝结算账号】两个字段均需填写正确

【支付宝】返回:“签约失败 系统处理异常,请联系owner,后续优化信息提示”

支付宝系统抖动

重试进件

【支付宝】返回:“支付宝账号和商户名不一致”

支付宝账号(用于协议确认)或支付宝结算账号,实名认证的名称与商户名称不匹配

1.支付宝账号(用于协议确认):用于开户过程中的协议确认,支付宝账号必须完成实名,且实名信息与商户名称相同

2.支付宝结算账号:用于资金提现,支付宝账号必须完成实名认证。商户类型是个体工商户时,支付宝结算账号实名可以与商户名称或者法定代表人姓名相同;其他情况下,支付宝结算账号必须与商户名称相同

【支付宝】返回:“填写的法人身份证号码存在风险,暂不支持修改”

触发支付宝风控

联系平台协助申诉

【支付宝】返回:“公安网校验失败”

法人姓名或身份证号填写错误 公安网返回库中无此号,可以联系用户确认是否存在信息变更,如果用户本身存在过信息变更,且当地户籍机关数据准确无误,那用户得等待数据更新,更新时间无法预估

修改为正确信息;

需要用户联系公安网进行信息更新,或过几天等公安网信息自动更新了再申请;

【支付宝】管理员信息填写错误,导致无法完成签约

已提交入网无法修改信息

重新进件

【支付宝】入驻返回:“BINDING_ALIPAY_ACCOUNT_EMPTY:身份指定支付宝账号为空”

未填写【支付宝账号(用于协议确认)】 填写的【支付宝账号(用于协议确认)】与商户名称不同名,或不是实名认证支付宝账户

填写【支付宝账号(用于协议确认)】重新提交

填写与商户名称同名,且是实名认证过的支付宝账户(企业需填写企业支付宝账户;个体必须用法人的支付宝账号)

支付宝账号注册及实名流程参考:

个人 https://opendocs.alipay.com/common/02kg61

企业 https://opendocs.alipay.com/common/02kkum

【支付宝】入驻返回:“未知的错误码AE0515021746”

支付宝返回:商户状态清退,入驻的商户账号历史上有重大违规。

让商户换个支付宝账号重新入驻。

具体的情况,可以引导商户自行致电95188进入人工服务咨询。

如商户已咨询支付宝反馈没问题,请商户确认反馈支付宝查询与提交入驻的支付宝账号是否为同一个

【支付宝】入驻返回:“重复进件,存在相同主体信息的二级商户****”

二级商户提交的主体已在服务商下入驻成功过二级商户,不支持重复入驻

告知商家,使用已入驻成功二级商户号即可

【支付宝】入驻返回:“未知的错误码AE0505021099”

支付宝系统抖动

稍后重试

【支付宝】入驻返回:“ADDRESS_DISTRICT_CODE_ILLEGAL:区码非法”


区码请按照https://gw.alipayobjects.com/os/basement_prod/253c4dcb-b8a4-4a1e-8be2-79e191a9b6db.xlsx 表格中内容填写的

【支付宝】入驻返回:“支付宝账号未实名”

1.支付宝账号没有实名认证

2.支付宝账号被冻结

1.需要用户进行实名认证

支付宝账号注册及实名流程参考:

个人 https://opendocs.alipay.com/common/02kg61

企业 https://opendocs.alipay.com/common/02kkum

2.需要用户联系95188客服解冻后再次进行进件操作

【支付宝】入驻返回:"DISTRICT-CODE-LLEGAL:地址码关联性有误。

未满足省-市-区这样的三级行政区域

需要满足省-市-区这样的三级行政区域 https://opendocs.alipay.com/support/01rfye

【支付宝】入驻返回:“卡类型非法”

结算卡填写成贷记卡,不支持贷记卡,只支持借记卡或对公账户

引导商家修改成结算卡为借记卡或对公账户

【支付宝】入驻返回:“开户行简称校验不合法”

1.银行卡信息是对私账号,传入的类型是对公账号

2.开户行信息和卡号对应不上

1.修改商户类型,或银行卡信息,对公对私需保持一致

2.重新确认下卡号和开户行并进行修改

【支付宝】入驻返回:“签约失败 限权中心商户不符合实名制标准,请检查输入信息,确保无误后再提交”

商户传入的支付宝账号不符合实名制标准,需要提供实名认证的支付宝账号

引导商家修改支付宝账号或完成支付宝账号的实名认证

支付宝账号注册及实名流程参考:

个人 https://opendocs.alipay.com/common/02kg61

企业 https://opendocs.alipay.com/common/02kkum

【支付宝】入驻报错“审核失败:风控审核状态:风控审核通过,风控审批备注:批量审理,客资审核状态:无需客资审批”

支付宝“签约失败 选择的行业暂不支持申请,建议更换行业”,支付宝mcc文档不准确

引导商户修改一二三级行业

【支付宝】入驻报错“审核失败:风控审核状态:风控审核通过,风控审批备注:通过,客资审核状态:无需客资审批”

一般是账号存在异常或者风控

联系平台协助申诉 https://opendocs.alipay.com/p/015co2

【支付宝】入驻报错“银行卡分支机构名称非法”

商家所选的结算信息中支行,支付宝不支持

建议换卡,或选择上级支行

【支付宝】入驻报错“存在风险”

二级商户账号异常

进件的二级商户账户异常,无法进件。

联系平台协助申诉 https://opendocs.alipay.com/p/015co2

【支付宝】修改报错“身份指定支付宝账号值改变”

修改【支付宝账号(用于协议确认)】字段导致

【支付宝账号(用于协议确认)】如之前的支付宝账号可正常使用,不可进行修改

【微信】商家入驻返回:商户号受限,不能成为接收方

该商户在微信侧被风控

可直接联系商户,此商户由于触发微信侧风控机制,无法在微信入驻成功,请保持交易健康正常。「且此问题是微信不让商户入驻,请商户联系微信处理」

【微信】商家入驻一直审核中

商家未完成账户验证

引导商家完成账户验证,如果页面上没有汇款验证的信息请联系平台

【微信】开户返回:“填写的法人身份证号码存在风险,暂不支持修改”

1.该法人信息在微信的黑名单内,或者触发微信风控

2.该法人涉嫌违规

3.命中黑名单,怀疑是黑产。工商局查询:依照《个体工商户年度报告办法》第十三条规定被标记为经营异常状态的个体工商户,向工商行政管理部门补报纸质年度报告并申请恢复正常记载状态。

4.法人名下的其他企业涉嫌经营我司暂未开放类目,被限制接入

引导商户拨打95017申诉

【微信】返回:“填写的商户名称存在风险,暂不支持修改;填写的银行卡号存在风险,暂不支持修改”

被微信黑名单拦截

触发微信规则,字节侧无法处理,需商户联系微信处理

【微信】返回:身份证号码,与营业执照不匹配

注册营业执照时使用的证件号和当前填写的证件号不一致

上传了错误的营业执照

使用工商网工商网信息查询系统 ,输入营业执照编号或者商户名称进行法人信息以及营业执照信息查询

【微信】返回:银行卡账号非经营者所拥有,请核实身份证信息或银行账号

1.对私:

个体户:银行卡信息不属于法人(商户名和银行卡的开户名不一致)

个人&小微:银行卡开户名不是入驻人本人

2.对公:商户名与结算卡户名不一致

引导商户更换银行卡

【微信】入驻报错“填写的法人身份证号码存在风险,暂不支持修改”

微信不支持入驻

微信侧原因,无法支持

结算信息开户银行或支行为“***农村商业银行”,找不到对应支行

未选择到对应银行

开户银行可选择以下银行尝试:农村商业银行、其他农村信用社(含部分农村商业银行)、其他商业银行、其他村镇银行

结算信息银行名称为“上海浦东发展银行”,找不到

搜“浦发银行”

搜“浦发银行”

【支付宝/微信】入驻,返回:“持卡人信息有误:银行卡相关信息不正确。请检查银行卡四要素(银行卡号、真实姓名、身份证号、银行预留手机)是否正确”

银行卡四要素填写错误(一般多为银行预留手机号不正确)

通知商家确认银行卡信息是否有问题,是否和银行预留信息一致 如不确认,联系开户行客服进行确认 如不是,修改信息

【支付宝/微信】入驻返回报错:“上传图片失败,请检查输入信息,确保无误后再提交”

上传图片太大,包括营业执照图片、法人证件图片

微信图片限制是2M以内; 支付宝图片限制是10M以内。

二、支付

支付调用流程如下:

  1. 开发者/服务商调用预下单接口:需调用预下单接口获取拉起收银台的相关参数;
  2. 开发者/服务商调用 tt.pay 拉起收银台:按照 tt.pay 的方法调起收银台,用户可在收银台上选择支付方式并确认支付;支付成功后会同步返回开发者/服务商前端支付结果。
  3. 支付完成后,开发者/服务商会接收到支付结果通知
  4. 如果开发者/服务商长时间未接收到结果通知,可以通过查询接口来主动查询订单支付状态。

三、结算及分账

用户支付后的资金会到收款商户的「在途账户」内,商户暂时无法操作提现;只有当商户履约并调用结算及分账接口时,资金才能从「在途账户」到「可提现账户」,只有「可提现账户」的资金才能提现到银行卡或支付渠道余额账户内;

在调用结算及分账接口时,如果收款商户需要将资金分给其合作方,则可在接口中传入分账明细,字节开放平台相关系统会按照传入的明细将资金分到合作方的「可提现账户」内,合作方可操作提现;

目前每笔订单只能结算 1 次。

3.1 调用节点

  1. 到店服务类订单(用户需要到店履约或到店核销):履约或核销后 3 天才可调用该接口发起结算及分账(核销状态需要通过订单信息同步接口传入);

核销后 3 天的计算逻辑:如果在 12.1 日上送的核销状态,那么 12.4 日零点后可随时发起结算及分账。

  1. 其他订单:支付成功 7 天后才可调用该接口发起结算及分账。

支付 7 天后的计算逻辑:如果在 12.1 日支付成功,那么 12.8 日零点后可随时发起结算及分账。

如未按规定时间调用,系统会驳回请求。

3.2 平台服务费收取规则

在分账环节,根据商户与字节平台的约定,字节开放平台会收取平台服务费,具体费用及费项以平台约定为准。

3.3 注意事项

  1. 每次发起分账的分账方最多不超过 4 个,如果超过 4 个分账方请联系对应的运营同学。
  2. 如需将收款商户资金分给其合作方,则分账比例最高为 29%,也就是分给其合作方的金额需 ≤ 待分账金额*29%(待分账金额=支付金额-退款金额)

四、退款

分账前或分账后均支持退款,且支持全额退或部分退款。

退款时需注意以下事项:

  1. 距离支付成功超 12 个月的订单不能退款,需要商户线下自行给用户退;
  2. 退款逻辑按照订单维度退,分账前发起退款,直接从「在途账户」退,分账后从「可提现账户」退;
  3. 「分账中」状态订单不支持退款,需要先完成/取消该单分账。

五、退分账

账单分账后,对已经分账的金额可以再次发起退分账,资金从分账接收方「可提现账户」回退到分账发起方「可提现账户」。

退分账时需要注意以下事项:

  1. 分账回退以原分账单为依据,支持多次回退,申请回退总金额不能超过原分账单分给该接收方的金额。
  2. 对同一个分账接收方最多能发起 20 次分账回退请求。
  3. 分账回退时限的有效期最长 180 天。
  4. 退分账接口频率限制 50qps。
  5. 只支持外部分账方的退分账,不支持平台抽佣、手续费等退分账。

六、提现

提现指的是将「可提现账户」资金转到商户进件时填写的银行卡或支付宝账号余额里

需要注意的是,提现请求发起成功不代表资金实际到达银行卡或支付宝余额里,银行或支付宝内部会有处理时效,预计 1-3 天可到账。

提现方式

使用方法

字节小程序开发者平台

字节小程序开放平台-【某小程序】-【功能管理】-【支付】-【支付产品】页面填写信息完成进件

接口提现

调用接口传入信息完成提现

接口获取提现页面链接

需调用接口获取提现页面链接,打开链接后在页面上发起提现

七、获取对账单

字节开放平台会提供支付,退款,分账,退分账的对账单,开发者或服务商可将平台提供的对账单与自己系统里的数据进行比对,如有差异先自行核验,必要时可联系平台技术支持同学处理;

通过接口获取对账单,对账单包括:支付账单,退款账单,分账账单,退分账账单。

每次只能获取 1 天或 1 月的对账单

获取日对账单:需在 D+1 日获取 D 日及之前的对账单

获取月对账单:在当月 3 号之后可以获取前一个月的账单

账单字段如下:

支付对账单

支付时间

商户号

openid

订单号

平台订单号

渠道订单号

订单金额

支付方式

支付状态

退款对账单

退款时间

商户号

OpenId

订单号

渠道订单号

订单金额

支付方式

退款类型

退款单号

平台退款单号

退款状态

退款完成时间

退款金额

退款模式

退款出资方

分账对账单

序号

分账时间

商户号

OpenId

订单号

平台订单号

渠道订单号

订单金额

支付方式

分账单号

分账状态

分账方和分账金额

软件服务费1

软件服务费2

抽佣金额

渠道分账单号

平台分账单号

退分账分账单

序号

退分账时间

订单号

商户号

OpenId

订单金额

支付方式

分账单号

分账完成时间

退分账单号

平台退分账单号

渠道退分账单号

退分账方

退分账金额

退分账完成时间

退分账状态

点击纠错
该文档是否对你的开发有所帮助?
有帮助
没帮助
该文档是否对你的开发有所帮助?
有帮助
没帮助