接入易错点

更新时间:2026.10.30
||| 安装 Skill

一、服务ID与账号绑定

注意事项

说明、正确应该怎么做

不做会怎么样

 请求商户与AppID须预先绑定服务ID

 说明:支付分服务ID用于标识具体服务场景;普通商户默认绑定申请时填写的商户号与 appid,服务商默认绑定服务商商户号、子商户号、appid 及可选的 sub_appid,后续新增组合须在服务ID下新增绑定;服务商模式下订单资金默认结算到子商户账户。
正确应该怎么做:① 申请支付分前先确认实际提供服务和收款的商户号、子商户号及对应 appid;② 将这些组合绑定到同一个服务ID,支付分订单创单、完结、查询和取消均使用同一组合;③ 支付分用户下单时不先付款,服务结束后由商户完成订单并从上述收款商户号扣款;④ 若后续新增子商户号或应用,按服务ID新增绑定流程处理,不能直接复用未绑定的商户号。
典型反例:支付分配置时填入与订单实际收款、扣款不一致的商户号,导致创单应用与实际支付场景不匹配。
见 4012587112-开发接入准备、4012586133-开发接入准备、4012586132-产品介绍、4012586139-常见问题 

 调用支付分时可能返回「商户请求错误,错误码:4188」或 NO_AUTH,无法正常使用已配置的服务ID;订单也可能无法从预期收款商户号完成扣款。 

 创单与拉起场景须使用同一AppID

 说明:调用支付分接口的商户号与 appid 必须已在对应服务ID下绑定;创建、完结和取消支付分订单使用的 appid 须保持一致。
正确应该怎么做:① 上线前核对服务ID已配置的商户号、appid 及可选的 sub_appid 组合;② 新增或更换 AppID 时,先按支付分服务ID配置流程完成绑定;③ 创单、完结和取消均读取同一份已绑定配置,不在不同接口切换到其他业务 AppID;④ 发现商户号与结单 AppID 无绑定关系时,先完成绑定再继续订单操作。
典型反例:创单时使用小程序 AppID,完结或取消时改用公众号或其他业务的 AppID。
见 4012587900-创建支付分订单、4012587905-取消支付分订单、4012587902-查询支付分订单、直连商户与AppID账号关联管理、4012587955-完结支付分订单、4012587200-微信支付分常见问题、4012587166-开发指引、4018398339-微信支付分权限类问题排查指南、4016328613-管理商户号绑定的APPID账号 

 商户号与结单 AppID 无绑定关系时无法取消或完结对应订单,支付分服务订单状态无法按预期结束;部分场景还可能返回 appid、NO_AUTH。 

二、确认模式与用户授权

注意事项

说明、正确应该怎么做

不做会怎么样

 需确认订单须使用正确的确认模式

 说明:需确认模式下每笔订单须由用户跳转至微信支付分页面确认;免确认模式属于高级权限,须特殊申请,仅即插即充等已核准场景可申请。常规充电不能直接配置为免确认模式。
正确应该怎么做:① 按实际充电场景确认适用的支付分模式;② 常规充电创单时固定传 need_user_confirm=true 或不传该字段,使用系统默认的需确认模式;③ 仅在实际具备即插即充能力且已取得免确认权限后,才按已核准参数创单;④ 联调前核验服务 ID 对应的模式权限,避免前端流程与后台权限不一致。
典型反例:为了减少用户确认步骤,在未取得高级权限时直接把 need_user_confirm 设为 false。
见 4012587166-开发指引、4012587200-常见问题、4012586132-微信支付分产品介绍、4013138534-创建支付分订单、4018398339-微信支付分权限类问题排查指南、4012587900-创建支付分订单、4012586134-开发指引(合作伙伴) 

 未取得权限时创单会因权限不足而失败;常规充电若错误配置为免确认,也不符合已核准的业务模式;部分场景还可能返回 NO_AUTH。 

 官方确认弹窗须通过支付分创单及拉起接口实现

 说明:需确认模式下,每笔订单须跳转微信支付分官方确认页,由用户确认;官方确认页需要先创建支付分订单,再使用创单返回的 package 通过支付分拉起接口打开,不是商户自制的确认页面。
正确应该怎么做:① 开通支付分权限并取得正确的服务 ID;② 调用创建支付分订单接口,需确认模式固定传 need_user_confirm=true,保存返回的 package;③ 小程序使用 wx.openBusinessView 等支付分确认订单接口传入 package,APP、公众号按对应载体接口拉起;④ 在确认回调或查询订单结果后进入后续服务流程。
典型反例:已申请支付分权限后,认为官方确认页会自动出现,直接以自制页面替代微信支付分确认页。
见 4012587050-产品介绍、4012587166-开发指引、4012587900-创建支付分订单、4012587949-小程序调起支付分确认订单页 

 用户看到的是商户自制页面而非微信支付分官方确认页,订单无法按官方确认流程完成,后续服务与扣款链路无法正常进入。

三、上线前测试号、页面规范与开发验收

注意事项

说明、正确应该怎么做

不做会怎么样

 申请支付分前须完成客服电话认证

 说明:支付分商户客服电话须经过微信支付认证并展示在账单详情页;提交支付分开通或验收资料时,订单页交互图也应清晰展示客服电话入口。
正确应该怎么做:① 按电话认证指引完成商户客服电话认证;② 在支付分订单详情、账单详情及申请材料所示页面中展示已认证的客服电话;③ 提交交互图、录屏或验收材料前,核对页面实际展示与认证号码一致。
典型反例:仅在内部资料或申请表中填写客服电话,但用户可见的订单页未展示。 

 支付分开通或验收资料会被驳回,服务无法上线,用户暂时不能使用支付分。

 上线前测试微信号须配置白名单

 说明:支付分服务上线前仅白名单中的微信号可以使用,微信没有独立的支付分生产测试环境;未加入白名单的用户无法正常完成支付分调试。
正确应该怎么做:① 登录商户平台进入【产品中心 > 我的产品 > 微信支付分 > 产品设置 > 配置测试号】;② 录入参与联调的测试微信号并提交;③ 联调完成后按支付分验收流程提交材料,验收通过并正式上线后再面向全部用户开放。
典型反例:使用未加入白名单的测试账号判断接口不可用,未区分上线前白名单限制与接口参数问题。
见 4012587248-测试微信号配置指引、4012587166-开发指引、4012587200-常见问题 

 非白名单用户拉起支付分时提示「暂无法使用此服务,微信支付分逐步开放中」,联调无法继续;服务上线前也不能直接向线上用户开放。

 上线前下单页须按支付分应用规范展示支付方式

 说明:微信支付分相关前端交互和品牌露出须符合《支付分合作品牌线上应用规范》,下单页应明确展示支付分支付方式及对应的LOGO、文案和分数门槛信息。
正确应该怎么做:① 从官方规范文档下载应用规范及素材;② 在下单入口和订单确认流程中按规范配置支付分LOGO、文案与分数门槛,保持支付分付款方式可识别;③ 验收时提交完整的产品流程录屏,并提供进行中、已完成、已取消三种订单状态详情截图。
典型反例:下单页只展示普通支付或笼统的信用支付入口,未露出支付分品牌与分数门槛;验收只提交零散页面截图,未包含取消订单流程。
见 4012587166-开发指引、4012587220-支付分合作品牌线上应用规范 

 上线验收会被驳回,支付分服务不能正式开放给用户;缺少取消订单截图或支付分方式展示不符合规范时,会直接阻塞验收上线。

 支付分页面文案与品牌须符合规范

 说明:支付分页面文案须符合合作品牌线上应用规范;产品名称应使用「微信支付分」,用户可见页面不得使用「信用」表述,免押场景应使用「押金」而非「保证金」。
正确应该怎么做:① 按《支付分合作品牌线上应用规范》逐页核对支付方式、按钮、表单和弹窗文案;② 将「微信信用分」统一改为「微信支付分」,删除页面中的「信用」字样;③ 将用户可见的「保证金」改为「押金」;④ 修改完成后按验收要求重新录制完整产品流程视频并提交复核。
典型反例:将支付方式写成「微信信用分」,或在免押借还页面显示「保证金」。
见 4012587166-开发指引、4012587955-完结支付分订单、4012587900-创建支付分订单、4012587220-支付分合作品牌线上应用规范、微信支付分合作品牌线上应用规范、4012586133-微信支付分开发接入准备 

 页面文案不符合品牌规范,产品流程视频和页面材料无法通过开发验收,支付分服务不能按期配置上线;部分场景还可能返回 post_payments。 

 支付分服务上线前须完成验收配置

 说明:支付分服务上线前仅白名单中的测试微信号可以使用;完成开发测试后,还须提交验收资料并通过微信支付验收,才能完成服务配置并向所有用户开放。
正确应该怎么做:① 登录商户平台,通过【产品中心 > 我的产品 > 微信支付分 > 产品设置 > 配置测试号】添加参与联调的测试微信号;② 使用测试微信号完成创单、用户确认、扣款、完结或取消等完整流程;③ 按开发指引准备第一人称产品流程录屏、线下场景第三方视角视频,以及进行中、已完成、已取消三种状态的支付分订单详情截图;④ 提供正式 service_id、服务名称、服务场景、商户号、预计上线时间、放量计划及应急隐藏入口方案;⑤ 验收通过并由微信支付完成服务配置后,再向全量用户开放入口。
典型反例:测试号可以调通后直接向全量用户开放入口,未提交验收资料,也未等待微信支付完成服务上线配置。
见 4012587166-开发指引、4012587248-测试微信号配置指引、4012586134-开发指引、4012586141-测试微信号配置指引、4012587112-开发接入准备、4012587200-常见问题 

 非白名单用户拉起支付分时提示「暂无法使用此服务,微信支付分逐步开放中」,服务不能正式上线,业务无法向全部用户开放。

四、分数门槛与用户综合评估

注意事项

说明、正确应该怎么做

不做会怎么样

 支付分门槛须与服务ID实际配置一致

 说明:支付分是否可用取决于服务ID对应的最低分数要求及订单风险金额等配置,页面不得自行填写与实际服务ID不一致的门槛;标准配置的服务ID分数门槛为550分。
正确应该怎么做:① 接入时向对接运营确认当前 service_id 的分数门槛和风险金额上限;② 如需在页面说明分数要求,使用该服务ID的实际配置值,不在小程序前端硬编码未经确认的数字;③ 服务ID或配置调整后同步更新页面展示和帮助说明。
典型反例:商户在小程序页面自行写“450分可用”,而实际服务ID门槛为550分,导致518分用户看到页面提示后仍无法使用。
见 4012586132-合作伙伴支付分产品介绍、4012586139-合作伙伴支付分常见问题 

 页面标准与实际门槛不一致,用户误以为分数已经达标,实际仍提示“支付分未达标”,无法授权开门或使用服务。

 支付分门槛不得在代码中写死为550分

 说明:支付分服务未单独调整时,标准配置的门槛为550分;已调整门槛的服务以申请或调整邮件记录中的配置为准,不应用一个固定分值覆盖所有服务ID。
正确应该怎么做:① 申请或接入时将当前 service_id 对应的分数门槛纳入服务配置清单;② 若服务曾调整门槛,按对接运营或邮件记录核对当前值;③ 不同服务ID分别读取对应门槛,不在公共代码中写死550;④ 后续准入判断以支付分确认页的单次综合评估结果为准。
典型反例:所有支付分服务共用一份“550分准入”配置,未核对具体服务ID是否已单独调整门槛。
见 4012587050-产品介绍、4012587200-常见问题、4012587112-开发接入准备 

 代码按已失效的固定门槛设计准入提示和业务分支,可能提前拦截本可使用支付分的用户,或向用户展示错误的使用条件。

 不得仅按550分判断用户可通过支付分

 说明:支付分是结合身份特质、支付行为和使用历史等形成的综合分值,达到商户设置的分数门槛只表示有机会使用权益;单次确认还会结合用户当前进行中或待支付订单、信用情况、实名稳定性及订单风险金额等综合评估。商户无法获取用户具体分值或明确的“分数不足”标识。
正确应该怎么做:① 创单时按实际场景填写 risk_fund.name 和 risk_fund.amount,金额须大于0且不超过服务ID风险金额上限;② 拉起支付分确认页,以页面返回的综合评估结果和订单状态决定是否提供权益;③ 先免模式评估不通过时保留缴纳押金等后续路径,先享模式评估不通过时停止本次先享服务;④ 不依赖用户提供的分数截图作为系统放行依据。
典型反例:业务代码只要认为用户“达到550分”就直接放行,不处理“综合评估未通过”的分支。
见 4012587050-产品介绍、4012587200-常见问题、4012587900-创建支付分订单 

 用户即使达到550分,仍可能收到「综合评估未通过」,无法使用免押或先享权益;若业务未设置失败分支,交易会直接中断。

 免押结果须按每笔订单综合评估

 说明:用户支付分达到服务ID门槛只是在有机会使用支付分,微信支付分还会结合实际支付行为、信用记录、实名稳定性、进行中或待支付订单以及商户创单传入的订单风险金额等因素综合评估;商户无法获取用户的具体支付分。用户分数较高不代表一定通过评估。
正确应该怎么做:① 先取得当前服务ID的最低分数门槛和服务风险金额上限;② 创单时按实际业务风险设置 risk_fund.amount,金额须大于0且不超过服务ID风险金额上限;③ 以支付分确认页面的实际评估结果和订单状态决定是否提供免押或先享服务,不在商户系统内按用户截图的分数自行放行;④ 先免模式评估未通过时按产品规则允许用户缴纳风险金,先享模式评估未通过时不得开始享受后付费服务。
典型反例:把支付分不低于550分硬编码为全局放行条件,或仅依据用户自行提供的支付分截图判断可用性,绕过支付分实际评估结果。
见 4012586132-合作伙伴支付分产品介绍、4012586134-合作伙伴支付分开发指引、4012586139-合作伙伴支付分常见问题、4012587050-产品介绍、4012587200-常见问题、4012587900-创建支付分订单、4012587166-开发指引、4020801380-错误码、4013138534-创建支付分订单 

 用户分数较高时仍可能返回 INVALID_REQUEST,提示「综合评估未通过」,无法使用支付分或创建支付分服务订单;商户若按本地分数逻辑承诺免押,实际拉起确认页时无法履约。 

 同一实名订单超限须按全商户累计

 说明:支付分评估按用户维度综合判断,用户当前进行中或待支付的支付分订单、信用记录、实名稳定性以及创单传入的风险金额都会影响评估;同一实名身份下进行中的订单一般不能超过 3 笔。
正确应该怎么做:① 创单前检查用户是否存在进行中或待支付的支付分订单,提示先完成或取消这些订单;② 创单时按实际场景填写 risk_fund.amount,且不超过服务 ID 风险金额上限;③ 评估未通过时按单次订单处理,不以支付分分数作为唯一放行条件;④ 保留押金、主动支付等兜底路径;⑤ 用户处理完其他订单后重新创单,仍不通过则按本次评估未通过处理。
典型反例:仅判断用户支付分高于商户门槛即放行,未处理用户在其他商户的进行中订单;把「综合评估未通过」直接等同于分数不足。
见 4012586139-常见问题、4012587248-测试微信号配置指引、4012587200-常见问题、4012587900-创建支付分订单、4020807411-错误码、4013138559-查询支付分订单、4012587166-开发指引、4020801380-错误码 

 调起支付分确认页时提示「综合评估未通过」,用户无法使用支付分;进行中订单达到上限时提示「同一实名身份下进行中订单过多」,本次交易无法继续;部分场景还可能返回 268497610。 

 超时未支付订单过多将限制创单

 说明:支付分按用户实名身份维度判断;同一实名身份下(包括其他已完成同一实名认证的微信号)超时未支付订单累计过多时,用户确认订单会被限制,需保持良好支付行为方可解除提示。
正确应该怎么做:① 用户确认订单出现该提示时,向其说明限制按实名身份统计,不按当前微信号统计;② 引导用户处理同一实名身份下的历史待支付订单,并保持良好支付行为。
典型反例:仅校验当前微信号的支付分订单状态,忽略同一实名身份下其他微信号存在的历史超时未支付订单。
见 4012587200-常见问题、4012587166-开发指引 

 用户扫码或确认订单时提示「同一实名身份下超时未支付订单过多」或「同一实名身份下超时未支付记录累计过多」,无法使用支付分完成下单。

五、证书、公钥与签名密钥

注意事项

说明、正确应该怎么做

不做会怎么样

 API证书与签名序列号须正确匹配

 说明:平台证书用于验证APIv3应答和回调签名,有效期5年;平台证书模式下,微信支付会提前加入新证书,商户应能够同时持有并识别新旧证书。若使用无过期时间的微信支付公钥模式,则应按公钥ID完成验签。
正确应该怎么做:① 先确认当前使用微信支付公钥还是平台证书模式;② 公钥模式在商户平台获取公钥和公钥ID,以 Wechatpay-Serial 中的公钥ID匹配验签;③ 平台证书模式首次使用证书工具获取证书,后续通过 GET /v3/certificates 下载全部有效期内的证书并缓存;④ 验签前检查 Wechatpay-Serial 是否与本地证书序列号一致,不一致时重新下载;⑤ 在旧证书到期前完成新旧证书并存、验签切换和回调验证,避免只在缓存中保留单张证书。
典型反例:仅在本地缓存一张平台证书,未处理新证书启用后的 Wechatpay-Serial 变化。
见 4024350132-证书密钥概览、4012587166-开发指引、4013053249-如何使用微信支付公钥验签、4013053420-如何使用平台证书验签名、4012551764-下载平台证书、4012068829-平台证书更换操作指引、4012365345-报错:商户证书序列号有误。请使用签名私钥匹配的证书序列号、4013070756-开发必要参数说明 

 平台证书到期或序列号切换后,APIv3应答验签或回调验签可能失败,支付分接口结果和异步通知无法正常处理,影响交易与对账;部分场景还可能返回 SIGN_ERROR。 

六、风险金额、封顶计费与行业付费明细

注意事项

说明、正确应该怎么做

不做会怎么样

 电商先享后付须传入准确的确认收货时间

 说明:电商先享后付订单页的自动确认收货时间由微信侧展示;商户可通过接口传入确认收货时间,未传入时按该业务配置的时间生效,本单默认按物流发货后 10 天计算。
正确应该怎么做:① 接入电商先享后付前,确认所用接口是否支持传入确认收货时间;② 在对应业务链路中通过该接口传入与实际履约、物流进度一致的确认收货时间,不要将系统默认时间当作准确收货日期。
典型反例:只依赖平台默认的“物流发货后 10 天”作为预计收货日期,在能够传入确认收货时间时仍不传,导致订单页日期与实际履约进度不一致。
见 4012586132-产品介绍、小程序发货信息管理服务、交易类小程序运营规范 

 用户订单页会展示不准确的预计确认收货日期并引发客诉;未传入确认收货时间时,系统按物流发货后 10 天自动确认收货。

 免押租借订单须设置封顶计费规则

 说明:微信支付分支持免押租借、先使用后付款等场景;商户应在创单时通过 post_payments 上传计费规则,在完结时按实际服务金额收款,订单金额不得超过服务 ID 风险金额上限。
正确应该怎么做:① 在产品页面和创单参数中明确计费规则及封顶金额;② 按场景规范填写 post_payments,先免模式下 risk_fund.amount 填写押金金额;③ 服务到期或用户归还后及时完结订单,并按 total_amount <= risk_fund.amount <= 服务 ID 风险金额上限 校验金额。
典型反例:按长期租赁设计订单,不设封顶金额,到期后一直不结束订单。
见 4012587050-产品介绍、4012587900-创建支付分订单、4012587955-完结支付分订单 

 订单长期滞留会被统一取消,租金无法收取;金额超过服务 ID 风险金额上限时,创单或完结会失败。

 先享模式预估金额须按订单费用填写

 说明:先享模式下,订单预估金额应填写业务场景中合理范围内的最高可能金额,建议按历史数据取覆盖95%以上场景的金额;订单实际完结金额不得超过服务ID风险金额上限,在不超过该上限时可以高于预估金额。
正确应该怎么做:① 向微信支付运营确认该服务ID的风险金额上限;② 统计业务历史数据,取覆盖95%以上场景的金额作为预估上限;③ 创建支付分订单时将 risk_fund.amount 设置为该预估上限;④ 完结订单时校验 total_amount 不超过服务ID风险金额上限,再调用完结接口。
典型反例:为提升授信通过率,故意把预估金额压到最低消费档,实际使用金额远高于预估,完结时无法按真实费用全额扣款。
见 4012587166-开发指引、4012587900-创建支付分订单、4012587955-完结支付分订单、4012587200-常见问题、4020801380-错误码 

 预估金额过低时,完结阶段实际费用可能超出可扣款范围,导致无法全额扣款;金额超过服务ID风险金额上限时返回 271316656 总金额超过此服务的服务风险金额,订单无法按目标金额创建或完结。 

 支付分订单金额不得超过服务上限

 说明:risk_fund.amount 为整型,单位是分,必须大于0,且不得超过该服务ID对应的服务风险金额上限;先免模式下完结订单的 total_amount 还须小于等于创单传入的风险金额,先享模式下须小于等于服务ID风险金额上限。
正确应该怎么做:① 接入前确认业务属于先免或先享模式,并向对接运营确认该 service_id 的风险金额上限;② 创单时按模式传入正确的 risk_fund.name,risk_fund.amount 按实际业务金额配置且控制在服务ID上限内;③ 完结前校验 total_amount = post_payments.amount总和 - post_discounts.amount总和,并再次核对当前模式对应的金额上限;④ 业务确需超过当前服务ID上限时,向对接运营申请评估。
典型反例:将风险金额配置为固定的服务端常量,未按当前服务ID的实际上限进行校验。
见 4012587166-开发指引、4012587900-创建支付分订单、4012587955-完结支付分订单、4012587200-支付分常见问题、4012587050-产品介绍、4013138534-创建支付分订单、4012586139-常见问题、4012586132-产品介绍、4012587112-开发接入准备、4012586134-开发指引、4013138598-完结支付分订单 

 创单可能报 PARAM_ERROR,提示“值低于最小值 1”或“创建订单的订单风险金额超过此服务的服务风险金额”;完结时可能报“总金额超过此服务的服务风险金额”,导致订单无法创建或无法完成收款;部分场景还可能返回 risk_fund.amount。 

 服务ID提额后须按新上限校验订单金额

 说明:支付分额度按服务ID维度调整,不是按单笔订单申请,该调额维度服务ID调整后,后续订单的最高可扣额度按新上限执行。服务风险金额及完结订单的 total_amount 均须不超过该服务ID的风险金额上限。
正确应该怎么做:① 按实际业务向对接运营确认并申请服务ID额度调整;② 保存调整后的服务ID风险金额上限,在创建支付分订单时校验 risk_fund.amount;③ 完结前校验 total_amount,先享模式下 total_amount 不得超过服务ID风险金额上限,先免模式下还须同时不超过创单时的风险金额。
典型反例:每笔高价订单单独提交提额申请,未按服务ID统一维护风险金额上限;提额完成后仍使用旧的固定金额上限校验创单和完结请求。
见 4013138534-创建支付分订单、4013138598-完结支付分订单、4012586139-常见问题 

 创单可能提示「创建订单的订单风险金额超过此服务的服务风险金额」;完结金额超过服务ID上限时,订单无法按该金额完成收款。

 支付分仅可代扣申请场景内费用

 说明:支付分用于先使用服务、后按本次实际服务付费;在充电桩场景,完结订单时后付费项目仅可回传「计费规则」和「费用明细」。月卡、年卡等非本次充电费用不属于该订单的后付费明细,应改为主动支付,并在页面标注对应扣费明细。
正确应该怎么做:① 区分本次充电产生的电费、服务费与月卡、年卡等会员费用;② 支付分创单和完结仅回传本次实际服务费用;③ 月卡、年卡改为主动支付,并在页面明确展示收费项目与扣费明细;④ 充电桩场景完结时严格按「计费规则」「费用明细」两类项目传 post_payments。
典型反例:在同一充电桩服务 ID 下,用支付分订单代扣与本次充电无关的月卡或年卡会员费。
见 4012587112-开发接入准备、4012587347-汽车充电桩、4012586133-合作伙伴开发接入准备、4012586149-汽车充电桩后付费项目、4012586150-二轮电动车充电桩后付费项目、4012587050-产品介绍、4012587166-开发指引、4012586142-支付分权限申请邮件模板、4012587220-支付分合作品牌线上应用规范 

 违规利用支付分代扣月卡、年卡费用会被要求整改;逾期未整改将关闭商户号创单至少 7 天,影响充电业务正常开展。

 充电订单须展示完整计费与费用明细

 说明:支付分订单的后付费项目会展示在支付分订单详情页;汽车充电桩商户在完结订单时必须同时回传“计费规则”和“费用明细”两类项目,且只能回传这两类项目。
正确应该怎么做:① 创单时通过 post_payments 回传计费规则;② 完结订单时同时回传计费规则与实际费用明细;③ 按 total_amount = 后付费项目金额 - 优惠项目金额 校验金额,确保订单页展示与实收一致。
典型反例:完结时只回传一个总金额,或把会员费等其他服务项目混入充电费用明细。
见 4012587166-开发指引、4012587347-汽车充电桩、4012587955-完结支付分订单 

 支付分订单页无法正常展示后付费项目,影响验收上线,并增加用户对订单金额的疑问。

 支付分订单须回传完整商品信息

 说明:智慧零售(无人设备)行业创建支付分订单时无需回传 post_payments,用户购买的商品信息应在完结订单时通过 post_payments 回传;post_payments 至少包含一笔名称为“商品信息”的项目,每个商品对应一条明细。
正确应该怎么做:① 创建订单时不传 post_payments;② 服务结束后调用完结支付分订单接口;③ 按实际购买商品逐条填写 post_payments,name 固定为“商品信息”,amount 填商品金额,description 填商品名称,count 填商品数量;④ 确认支付分订单明细可展示商品信息后再提交验收。
典型反例:只在商户自己的订单页展示商品,未在完结接口的 post_payments 中回传;或把多个商品合并成一个笼统的“费用”项目。
见 4012587317-post_payments(后付费项目)字段传参说明-智慧零售(无人设备)、4012587955-完结支付分订单、4012587166-开发指引、4012587200-常见问题 

 支付分订单明细无法展示商品信息,验收无法通过,影响服务上线;部分场景还可能返回 post_payments。 

 不得将支付分扣款用于惩罚性扣款

 说明:智慧零售(无人设备)行业完结支付分订单时,post_payments 只允许回传“商品信息”,且应准确反映用户实际购买的商品、金额和数量;官方整改通知明确商户不得以罚款名义扣费。
正确应该怎么做:① 智慧零售场景创单时不传 post_payments,服务结束后在完结接口按实际购买商品逐条回传;② 每项 name 固定为“商品信息”,description 填写商品名称,amount 填写金额,count 填写数量;③ 多个商品分别生成明细,金额合计与 total_amount 的计算关系保持一致;④ 库存短缺扣费只能对应用户实际缺少的商品,并保留商品清单和监控视频等可核实凭证,不设置固定罚款或管理处罚项目。
典型反例:把设备损坏、遮挡摄像头或疑似未付款直接映射为一笔固定金额的“罚款”,再包装成“商品信息”扣款。
见 4012586146-智慧零售无人设备后付费项目、4013138598-完结支付分订单、4012587317-智慧零售(无人设备)、4012587955-完结支付分订单 

 用户不认可扣款并要求退款;逾期未整改时,商户号创单能力将被关闭至少7天,提交整改资料并审核通过后才能恢复,期间无法继续创建支付分订单。

 快递支付分须合并首重续重扣款

 说明:快递行业完结支付分订单时,post_payments 只允许传“首重费、续重费、包装费、保价费”,且必须包含一笔“首重费”;如果实际还有续重、包装或保价费用,应按实际项目补充。不能将首重费走其他支付渠道,仅把续重费交由支付分代扣。
正确应该怎么做:① 订单创建时通过 post_payments 回传本次快递的预估费用;② 服务结束后调用完结支付分订单接口,post_payments 至少包含“首重费”,并按实际情况增加“续重费”等费用项;③ 未产生续重费用时仅回传“首重费”,不得通过其他渠道另收首重费。
典型反例:用户先在普通支付页面支付首重费,快递员称重后再用支付分只代扣续重费。
见 4012587050-产品介绍、4012587304-快递行业、4012586132-产品介绍、4012586144-快递行业 

 支付分订单的后付费明细不符合快递行业传参要求,无法按要求完成订单展示与完结核对,影响支付分业务验收及正常上线。

 无人设备订单须回传唯一设备ID

 说明:售货机、充电宝、充电桩等无人自助设备行业,在创建支付分订单、完结支付分订单及修改订单金额时,须通过 device.start_device_id、device.end_device_id 回传设备在对应服务ID下的唯一标识,建议采用设备SN值。
正确应该怎么做:① 为每个 service_id 建立稳定的设备ID与SN映射,确保同一设备在服务ID下唯一;② 创建支付分订单时按接口要求回传对应的开始、结束设备ID;③ 服务结束时在完结接口回传与实际服务一致的开始、结束设备ID;④ 修改订单金额时同步回传对应设备ID,保证创单、完结、改额三个环节信息一致;⑤ 同一主体存在多个服务ID时逐一核对各自订单的设备回传情况。
典型反例:只在创建订单时回传设备ID,完结或修改金额时省略;设备ID仅在商户内部唯一,未按服务ID维度建立唯一映射。
见 4012587900-创建支付分订单、4012587957-修改订单金额、4012587955-完结支付分订单、4013138534-创建支付分订单、4013138819-修改支付分订单金额、4013138598-完结支付分订单、《自助行业设备信息库建设及接口改造》公告 

 支付分订单被判定为设备信息未回传或回传不准确;逾期未整改可能被调整提现结算周期、拦截不合规交易、暂停新增或停止合作,支付分业务无法正常开展。