报关接口常见问题Q&A
Q：支付单申报规则是怎样的 A：支付单申报规则有以下几点： 1、如果没有拆单，就以支付时的out_trade_no和transaction_id、原支付单对应的人民币金额（如有部分退款，减去部分退款金额）申报 2、如果拆单了，就以申报接口传的商户子单号sub_order_no和接口返回的子支付单号sub_order_id、申报接口传的order_fee金额申报 3、拆单的判断标准：调用支付申报接口时，商户传了sub_order_no就认为是拆单 Q：报关调用“订单附加信息提交接口”成功后，到海关清关返回：支付信息不存在 A：请按照以下几点检查： 1、新接入的商户：通常是因为商户推送订单使用的海关备案号、商户单号、支付单号与推送支付单使用的不一致(特别关注是否使用了拆单，然后单号不一致) 2、已上线的商户：可能是海关系统出现异常，请商户调用微信支付重推接口重推支付单(重推接口文档：https://pay.weixin.qq.com/wiki/doc/api/external/declarecustom.php?chapter=18_4&index=3) Q：报关调用“订单附加信息提交接口”返回：商户不支持该海关 A：请按照以下几点检查： 1、请求参数海关（customs）与商户后台添加的海关类型不匹配 2、请求参数海关备案号（mch_customs_no）与商户后台添加的海关备案号不匹配 Q：报关调用“订单附加信息提交接口”返回：交易单信息有误 A：请求参数中微信订单号与商户号不匹配，请填写该订单号对应正确的商户号 Q：多个商户主体需要开通报关业务，需要用哪个主体 A：如果商户用A主体在海关备案，就用A的主体开报关业务 Q：报关调用“订单附加信息提交接口”返回：商户不支持申报 A：请按照以下几点检查： 1、请登陆商户平台-产品中心-自助清关，检查是否有开通自助清关功能，如果未开通，请开通后再调用接口 2、商户平台没有添加海关备案信息，请按照文档要求，正确添加海关备案信息（添加备案信息指引： https://pay.weixin.qq.com/wiki/doc/api/external/declarecustom.php?chapter=17_1&index=1） Q：报关调用“订单附加信息提交接口”返回：签名错误 A：请按照以下几点进行排查： 1、使用签名检查工具（https://pay.weixin.qq.com/wiki/doc/api/micropay.php?chapter=20_1）校验签名算法是否有误 2、确认秘钥是否有误（服务商模式使用服务商商户号秘钥，秘钥是在商户平台配置，如果同一商户号调用其它接口成功可排除是秘钥问题） 3、确认接口实际的请求参数与生成签名原串的参数一致，不能增加或缺少参数（可通过打印签名原串进行排查） 4、确认参数的大小写，参数名与接口文档一致 5、签名原串的参数值使用原始值，不需要encode 6、接口需要使用UTF-8编码 7、签名不需要参数nonce_str，请去掉 Q：报关调用“订单附加信息提交接口”返回：商户海关申报重入信息不一致 A：请按照以下几点检查： 1、如果重复调用订单附加信息提交接口，所有请求参数必须与第一次请求参数一致 2、商户修改请求参数后重新调用“订单附加信息提交接口”，请求接口中的参数action_type需传MODIFY Q：报关的重推接口是哪个 A：重推接口文档如下： https://pay.weixin.qq.com/wiki/doc/api/external/declarecustom.php?chapter=18_4&index=3 Q：报关调用“订单附加信息提交接口”返回：您的操作已提交，请确认是否已生效 A：请按照以下几点检查： 1、微信订单号与商户号不匹配，请仔细检查确认 2、重复提交请求，修改了用户实名信息，请求参数中需传action_type为 MODIFY Q：报关调用“订单附加信息查询接口”返回：查询指定记录不存在 A：请按照以下几点检查： 1、请求参数中，微信订单号或商户订单号与商户号不匹配引起，请仔细检查 2、没用“调用订单附加信息提交接口”，请先调用“订单附加信息提交接口”后再调用查询接口发起查询 Q：报关调用“订单附加信息提交接口”返回：支付人与订购人信息不一致 A：请按照以下几点检查： 1、请求参数中，用户实名信息（cert_type，cert_id，name）填写错误，参数修改正确后，请求参数action_type填写为MODIFY，再次调用“订单附加信息提交接口”重新报关即可 2、需要商户联系用户在微信内修改为正确的身份证信息后，再重新下单支付，才可以顺利报关，原订单可以做退款处理 Q：要推送的海关不在接口文档列表里面，要选择哪个海关 A：接口文档列表没有的海关，商户在商户平台新增海关备案信息时选“广州（总署）”，备案号和备案名称填商户在海关登记的信息，然后按商户平台登记的信息调用“订单附加信息提交接口”即可 Q：调用报关接口，拆单的订单只能有一个子订单吗 A：拆单允许出现多个不同的子订单，需要多次调用报关接口 Q：拆单场景下，报关接口的拆单应付金额（order_fee）怎么填写 A：拆单场景的应付金额，只需要不超过原订单金额即可 Q：境内/境外机构服务商模式下的子商户是否支持调用报关接口 A：支持。境内普通直连商户，普通服务商 /境外机构商户，请使用境内/境外机构的商户号调用申报接口，在境内/境外机构的商户后台配置子商户的海关备案信息 Q：境内服务商模式的订单是否支持调用报关接口 A：支持。境内服务商商户，请使用统一下单中的子商户号调用申报接口，在服务商商户后台配置子商户的海关备案信息 Q：报关调用“订单附加信息提交接口”返回：商户未在当前申报的海关进行备案 A：请按照以下几点检查： 1、商户未在海关备案 2、商户没有把海关备案信息添加到商户平台 3、商户在商户平台添加的海关备案信息不正确 Q：部分退款的订单，海关申报规则是怎样 A：部分退款订单的申报规则如下： 1、如果是退款前申报，默认是按照支付订单金额来申报 2、如果是退款后申报，默认就按照退款后剩余的金额来申报 3、如果是申报后发生退款，调用“订单附加信息提交接口”传参数action_type=MODIFY重新推送即可 Q：报关调用“订单附加信息提交接口”，传参数action_type=MODIFY ，可以修改哪些参数 A：可修改的参数为：身份信息、 备案信息、备案号、 金额 Q：报关调用“订单附加信息提交接口”返回：XML参数格式错误 A：请按照以下几点检查： 1、请求参数不符合XML格式要求，请仔细检查 2、请求参数错误，比如把参数APPID填写为原始ID Q：报关调用“订单附加信息提交接口”返回：cert_check_result为DIFFERENT A：请按照以下几点检查： 1、UNCHECKED 商户未上传订购人身份信息 2、SAME 商户上传的订购人身份信息与支付人身份信息一致 3、DIFFERENT 商户上传的订购人身份信息与支付人身份信息不一致 Q：报关调用“订单附加信息查询接口”返回：NO_AUTH A：请检查当前商户号是否已获得此接口的调用权限，请按照以下链接指引申请开通权限（https://pay.weixin.qq.com/wiki/doc/api/external/declarecustom.php?chapter=17_1&index=1） Q：报关调用“订单附加信息提交接口”返回：拆单金额不正确 A：子订单金额，以分为单位，不能超过原订单金额，order_fee=transport_fee+product_fee（应付金额=物流费+商品价格） Q：报关调用“订单附加信息查询接口”会返回哪几种状态码 A：返回的状态码有以下几种： 1、UNDECLARED -- 未申报 2、SUBMITTED -- 申报已提交 3、PROCESSING -- 申报中 4、SUCCESS -- 申报成功 5、FAIL-- 申报失败 6、EXCEPT --海关接口异常 Q：报关调用“订单附加信息提交接口”推送广州南沙国检，推送规则是怎样的 A：推送广州南沙国检规则如下：商户需在广州总署备案，并把海关备案信息添加到商户平台，推送广州总署即可 Q：报关调用“订单附加信息查询接口”返回：电商平台未按照海关总署179号公告要求改造 A：这个报错的原因是电商平台没有按海关要求去报关相关数据，导致出错了，商户要按海关要求完成改造后即可正常报关，具体改造可以找海关问下 Q：报关调用“订单附加信息提交接口”返回：用户非身份证实名注册，不允许报关 A：请按照以下几点检查： 1、根据海关的要求，报关只支持大陆身份证实名认证的微信用户（非身份证实名认证的微信用户，不支持报关） 2、用户使用了亲属卡支付，下单人是A，支付人是C，应使用支付人C的实名信息报关 Q：报关调用“订单附加信息提交接口”报关成功后，在海关清单时返回：区内企业名称，需与企业备案时所填写名称一致 A：请按照以下几点检查： 1、商户在海关备案的商户名称，需要正确添加到商户平台 2、添加到商户平台的商户名称有括号的话也要区分清楚是中文括号还是英文括号，包括要区分圆角和半角 3、商户如果更换了主体，旧主体支付的订单可以这样处理即可正常报关（先调用“订单附加信息提交接口”-->再调用“订单附加信息重推接口”-->最后调用“订单附加信息提交接口”传参数action_type=MODIFY即可） Q：报关调用“订单附加信息提交接口”返回：UNDECLARED A：返回这个状态，请注意以下几点： 1、不管是第一次调用申报接口成功，还是调用重推接口成功，初始状态都是UNDECLARED，是待申报的意思。后续微信支付后台会异步批量提交给海关，大概几分钟的时间，状态就会正常 2、报关第一次申报后想看状态结果需要主动调用“订单附加信息查询接口”去查询，如果不查询或者不成功直接重推也ok ，最后清关结果才是准确的 Q：亲属卡支付的订单，是用谁的（下单的和支付的）实名信息报关 A：亲属卡支付的订单，是用付款人的实名信息报关，比如A给B开了亲情卡，B支付，扣A的钱，交易单中留A的信息 Q：报关调用“订单附加信息提交接口”返回：第1个支付节点的电商平台代码填写有误 A：请求参数“海关备案号”不正确，请检查是否在海关变更过备案信息 Q：报关调用“订单附加信息提交接口”返回：无效的海关备案号长度 A：请按照以下几点检查： 1、请求参数mch_customs_no中多了空格 2、海关备案号一般为10位字符串，请检查海关备案号是否正确 Q：报关调用“订单附加信息提交接口”返回交易币种与商户结算币种不一致 A：调用报关接口传入子订单号（sub_order_no)时，币种参数（fee_type)必填，请检查所传币种参数（fee_type）是否为空 Q：报关调用“订单附加信息提交接口”，如果订单发生了部分退款，该怎样申报 A：请按照以下几点提示申报： 1、如果是退款前申报，默认是按照支付订单金额来申报 2、如果是退款后申报，默认就按照退款后剩余的金额来申报 3、如果是申报后发生退款，可以调用申报接口，传报关类型为修改action_type=MODIFY，重新申报推单即可 Q：报关调用“订单附加信息提交接口”，实名不一致的情况下是否会返回：验核机构、验核机构交易流水号 A：请求参数传action_type=ADD或action_type=MODIFY，实名不一致的情况下都会返回上面的两个参数 Q：报关调用“订单附加信息提交接口”拆单场景下，拆单应付金额怎么填写 A：拆单的应付金额，微信报关接口只校验不超过总单号的支付金额，不会子单号一个一个校验 Q：在商户平台添加海关备案信息，有天津国检和天津海关，该添加哪个 A：在微信支付商户管理后台登记备案信息时，天津和天津国检都要登记备案信息，调用接口的时候，只需要报天津海关即可 Q：报关调用“订单附加信息提交接口”返回：132021060您的操作已提交，请确认是否已生效 A：用户实名有问题，请找用户确认是否有实名认证或是否是用户把微信支付账户注销了 Q：报关调用“订单附加信息提交接口”返回：132021058 您的操作已提交，请确认是否已生效 A：这个错误码的意思是： 未配置天津国检，不允许申报。需要推送订单至天津海关时，需要在商户管理后台同时配置天津海关备案信息与天津国检备案信息；调用报关接口时只需推送天津海关，即请求一次报关接口 Q：报关接口，单笔订单拆单数量有上限么 A：有上限的，一个订单，最多拆50个 Q：支付的订单使用了优惠券，请求报关的时候报给海关的金额是多少 A：使用了优惠券的订单，报给海关的金额就是订单支付的总金额（用户实际支付的金额+优惠券金额） Q：报关调用“订单附加信息提交接口”返回：该订单没有申报 A：接口调用错误。没有申报过的订单，请调用订单附加信息提交接口，不要调用重推接口 https://pay.weixin.qq.com/wiki/doc/api/external/declarecustom.php?chapter=18_1 订单附加信息提交接口文档 Q：订单附加信息提交接口的请求频率是多少 A：请求频率是600/s Q：订单附加信息提交接口，验核机构(verify_department)和验核机构交易流水号(verify_department_trade_id)的作用是什么 A：海关的要求，表示支付来源，支付渠道，商户需要把这两个信息在清关三单对碰的时候提交给海关
