接入易错点
更新时间:2026.10.30一、服务ID与账号绑定
注意事项 | 说明、正确应该怎么做 | 不做会怎么样 |
|---|---|---|
请求商户与AppID须预先绑定服务ID | 说明:支付分服务ID用于标识具体服务场景;普通商户默认绑定申请时填写的商户号与 | 调用支付分时可能返回「商户请求错误,错误码:4188」或 |
创单与拉起场景须使用同一AppID | 说明:调用支付分接口的商户号与 | 商户号与结单 AppID 无绑定关系时无法取消或完结对应订单,支付分服务订单状态无法按预期结束;部分场景还可能返回 |
二、确认模式与用户授权
注意事项 | 说明、正确应该怎么做 | 不做会怎么样 |
|---|---|---|
需确认订单须使用正确的确认模式 | 说明:需确认模式下每笔订单须由用户跳转至微信支付分页面确认;免确认模式属于高级权限,须特殊申请,仅即插即充等已核准场景可申请。常规充电不能直接配置为免确认模式。 | 未取得权限时创单会因权限不足而失败;常规充电若错误配置为免确认,也不符合已核准的业务模式;部分场景还可能返回 |
官方确认弹窗须通过支付分创单及拉起接口实现 | 说明:需确认模式下,每笔订单须跳转微信支付分官方确认页,由用户确认;官方确认页需要先创建支付分订单,再使用创单返回的 | 用户看到的是商户自制页面而非微信支付分官方确认页,订单无法按官方确认流程完成,后续服务与扣款链路无法正常进入。 |
三、上线前测试号、页面规范与开发验收
注意事项 | 说明、正确应该怎么做 | 不做会怎么样 |
|---|---|---|
申请支付分前须完成客服电话认证 | 说明:支付分商户客服电话须经过微信支付认证并展示在账单详情页;提交支付分开通或验收资料时,订单页交互图也应清晰展示客服电话入口。 | 支付分开通或验收资料会被驳回,服务无法上线,用户暂时不能使用支付分。 |
上线前测试微信号须配置白名单 | 说明:支付分服务上线前仅白名单中的微信号可以使用,微信没有独立的支付分生产测试环境;未加入白名单的用户无法正常完成支付分调试。 | 非白名单用户拉起支付分时提示「暂无法使用此服务,微信支付分逐步开放中」,联调无法继续;服务上线前也不能直接向线上用户开放。 |
上线前下单页须按支付分应用规范展示支付方式 | 说明:微信支付分相关前端交互和品牌露出须符合《支付分合作品牌线上应用规范》,下单页应明确展示支付分支付方式及对应的LOGO、文案和分数门槛信息。 | 上线验收会被驳回,支付分服务不能正式开放给用户;缺少取消订单截图或支付分方式展示不符合规范时,会直接阻塞验收上线。 |
支付分页面文案与品牌须符合规范 | 说明:支付分页面文案须符合合作品牌线上应用规范;产品名称应使用「微信支付分」,用户可见页面不得使用「信用」表述,免押场景应使用「押金」而非「保证金」。 | 页面文案不符合品牌规范,产品流程视频和页面材料无法通过开发验收,支付分服务不能按期配置上线;部分场景还可能返回 |
支付分服务上线前须完成验收配置 | 说明:支付分服务上线前仅白名单中的测试微信号可以使用;完成开发测试后,还须提交验收资料并通过微信支付验收,才能完成服务配置并向所有用户开放。 | 非白名单用户拉起支付分时提示「暂无法使用此服务,微信支付分逐步开放中」,服务不能正式上线,业务无法向全部用户开放。 |
四、分数门槛与用户综合评估
注意事项 | 说明、正确应该怎么做 | 不做会怎么样 |
|---|---|---|
支付分门槛须与服务ID实际配置一致 | 说明:支付分是否可用取决于服务ID对应的最低分数要求及订单风险金额等配置,页面不得自行填写与实际服务ID不一致的门槛;标准配置的服务ID分数门槛为550分。 | 页面标准与实际门槛不一致,用户误以为分数已经达标,实际仍提示“支付分未达标”,无法授权开门或使用服务。 |
支付分门槛不得在代码中写死为550分 | 说明:支付分服务未单独调整时,标准配置的门槛为550分;已调整门槛的服务以申请或调整邮件记录中的配置为准,不应用一个固定分值覆盖所有服务ID。 | 代码按已失效的固定门槛设计准入提示和业务分支,可能提前拦截本可使用支付分的用户,或向用户展示错误的使用条件。 |
不得仅按550分判断用户可通过支付分 | 说明:支付分是结合身份特质、支付行为和使用历史等形成的综合分值,达到商户设置的分数门槛只表示有机会使用权益;单次确认还会结合用户当前进行中或待支付订单、信用情况、实名稳定性及订单风险金额等综合评估。商户无法获取用户具体分值或明确的“分数不足”标识。 | 用户即使达到550分,仍可能收到「综合评估未通过」,无法使用免押或先享权益;若业务未设置失败分支,交易会直接中断。 |
免押结果须按每笔订单综合评估 | 说明:用户支付分达到服务ID门槛只是在有机会使用支付分,微信支付分还会结合实际支付行为、信用记录、实名稳定性、进行中或待支付订单以及商户创单传入的订单风险金额等因素综合评估;商户无法获取用户的具体支付分。用户分数较高不代表一定通过评估。 | 用户分数较高时仍可能返回 |
同一实名订单超限须按全商户累计 | 说明:支付分评估按用户维度综合判断,用户当前进行中或待支付的支付分订单、信用记录、实名稳定性以及创单传入的风险金额都会影响评估;同一实名身份下进行中的订单一般不能超过 3 笔。 | 调起支付分确认页时提示「综合评估未通过」,用户无法使用支付分;进行中订单达到上限时提示「同一实名身份下进行中订单过多」,本次交易无法继续;部分场景还可能返回 |
超时未支付订单过多将限制创单 | 说明:支付分按用户实名身份维度判断;同一实名身份下(包括其他已完成同一实名认证的微信号)超时未支付订单累计过多时,用户确认订单会被限制,需保持良好支付行为方可解除提示。 | 用户扫码或确认订单时提示「同一实名身份下超时未支付订单过多」或「同一实名身份下超时未支付记录累计过多」,无法使用支付分完成下单。 |
五、证书、公钥与签名密钥
注意事项 | 说明、正确应该怎么做 | 不做会怎么样 |
|---|---|---|
API证书与签名序列号须正确匹配 | 说明:平台证书用于验证APIv3应答和回调签名,有效期5年;平台证书模式下,微信支付会提前加入新证书,商户应能够同时持有并识别新旧证书。若使用无过期时间的微信支付公钥模式,则应按公钥ID完成验签。 | 平台证书到期或序列号切换后,APIv3应答验签或回调验签可能失败,支付分接口结果和异步通知无法正常处理,影响交易与对账;部分场景还可能返回 |
六、风险金额、封顶计费与行业付费明细
注意事项 | 说明、正确应该怎么做 | 不做会怎么样 |
|---|---|---|
电商先享后付须传入准确的确认收货时间 | 说明:电商先享后付订单页的自动确认收货时间由微信侧展示;商户可通过接口传入确认收货时间,未传入时按该业务配置的时间生效,本单默认按物流发货后 10 天计算。 | 用户订单页会展示不准确的预计确认收货日期并引发客诉;未传入确认收货时间时,系统按物流发货后 10 天自动确认收货。 |
免押租借订单须设置封顶计费规则 | 说明:微信支付分支持免押租借、先使用后付款等场景;商户应在创单时通过 | 订单长期滞留会被统一取消,租金无法收取;金额超过服务 ID 风险金额上限时,创单或完结会失败。 |
先享模式预估金额须按订单费用填写 | 说明:先享模式下,订单预估金额应填写业务场景中合理范围内的最高可能金额,建议按历史数据取覆盖95%以上场景的金额;订单实际完结金额不得超过服务ID风险金额上限,在不超过该上限时可以高于预估金额。 | 预估金额过低时,完结阶段实际费用可能超出可扣款范围,导致无法全额扣款;金额超过服务ID风险金额上限时返回 |
支付分订单金额不得超过服务上限 | 说明: | 创单可能报 |
服务ID提额后须按新上限校验订单金额 | 说明:支付分额度按服务ID维度调整,不是按单笔订单申请,该调额维度服务ID调整后,后续订单的最高可扣额度按新上限执行。服务风险金额及完结订单的 | 创单可能提示「创建订单的订单风险金额超过此服务的服务风险金额」;完结金额超过服务ID上限时,订单无法按该金额完成收款。 |
支付分仅可代扣申请场景内费用 | 说明:支付分用于先使用服务、后按本次实际服务付费;在充电桩场景,完结订单时后付费项目仅可回传「计费规则」和「费用明细」。月卡、年卡等非本次充电费用不属于该订单的后付费明细,应改为主动支付,并在页面标注对应扣费明细。 | 违规利用支付分代扣月卡、年卡费用会被要求整改;逾期未整改将关闭商户号创单至少 7 天,影响充电业务正常开展。 |
充电订单须展示完整计费与费用明细 | 说明:支付分订单的后付费项目会展示在支付分订单详情页;汽车充电桩商户在完结订单时必须同时回传“计费规则”和“费用明细”两类项目,且只能回传这两类项目。 | 支付分订单页无法正常展示后付费项目,影响验收上线,并增加用户对订单金额的疑问。 |
支付分订单须回传完整商品信息 | 说明:智慧零售(无人设备)行业创建支付分订单时无需回传 | 支付分订单明细无法展示商品信息,验收无法通过,影响服务上线;部分场景还可能返回 |
不得将支付分扣款用于惩罚性扣款 | 说明:智慧零售(无人设备)行业完结支付分订单时, | 用户不认可扣款并要求退款;逾期未整改时,商户号创单能力将被关闭至少7天,提交整改资料并审核通过后才能恢复,期间无法继续创建支付分订单。 |
快递支付分须合并首重续重扣款 | 说明:快递行业完结支付分订单时, | 支付分订单的后付费明细不符合快递行业传参要求,无法按要求完成订单展示与完结核对,影响支付分业务验收及正常上线。 |
无人设备订单须回传唯一设备ID | 说明:售货机、充电宝、充电桩等无人自助设备行业,在创建支付分订单、完结支付分订单及修改订单金额时,须通过 | 支付分订单被判定为设备信息未回传或回传不准确;逾期未整改可能被调整提现结算周期、拦截不合规交易、暂停新增或停止合作,支付分业务无法正常开展。 |
