收藏
评论

报关接口常见问题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、已上线的商户:可能是海关系统出现异常,请商户调用微信支付重推接口重推支付单


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:若传用户实名信息,则证件类型,证件号码,姓名需同时传递


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:请按照以下几点检查:

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:推送广州南沙国检规则如下:

1、商户需要分别在广州南沙国检和广州总署备案,并把海关备案信息添加到商户平台

2、需推送订单至南沙国检的订单需分别推送广州(总署版)和广州南沙国检,即需要请求两次报关接口


Q:报关调用“订单附加信息查询接口”返回:电商平台未按照海关总署179号公告要求改造

A:这个报错的原因是电商平台没有按海关要求去报关相关数据,导致出错了,商户要按海关要求完成改造后即可正常报关,具体改造可以找海关问下


Q:报关调用“订单附加信息提交接口”返回:用户非身份证实名注册,不允许报关

A:请按照以下几点检查:

1、根据海关的要求,报关只支持大陆身份证实名认证的微信用户(非身份证实名认证的微信用户,不支持报关)

2、用户使用了亲属卡支付,下单人是A,支付人是C,应使用支付人C的实名信息报关


Q:报关调用“订单附加信息提交接口”报关成功后,在海关清单时返回:区内企业名称,需与企业备案时所填写名称一致

A:请按照以下几点检查:

1、商户在海关备案的商户名称,需要正确添加到商户平台

2、添加到商户平台的商户名称有括号的话也要区分清楚是中文括号还是英文括号,包括要区分圆角和半角


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:用户实名有问题,请找用户确认是否有实名认证或是否是用户把微信支付账户注销了

最后一次编辑于  2019-11-18
收藏

14 个评论

  • Nice
    Nice
    2019-08-23

    我也遇到同样的问题求解决

    2019-08-23
    赞同 3
    回复
  • 杨铝杰
    杨铝杰
    2019-05-19

    Q11:提交报关接口返回以下错误:35311004,您的操作已提交,请确认是否已生效,这个错误是什么原因? 

    A11:请求参数name没有上传引起,身份信息的三个字段,要不三个字段都不传,要传就都传全才可以,请注意。

    我把请求的参数关于身份信息的属性也全部删掉了,还是出现这个问题,能不能解答一下是什么原因?谢谢

    2019-05-19
    赞同 1
    回复
  • jinshan
    jinshan
    2019-12-11

    请问发送海关的最后一项“总署”的customs编码是什么啊?帮助文档中没有

    2019-12-11
    赞同
    回复
  • 笑容
    笑容
    2019-11-01

    通知财付通报关,回执ORDER_NEED_DECLARE(该订单没有申报),这个错误代码,是指支付未成功吗,重推也是这样的回执!

    2019-11-01
    赞同
    回复
  • 勾勾
    勾勾
    2019-09-11

    订单号:201909093441496 报关返回:UNDECLARED -- 未申报

    请问怎么解决。

    2019-09-11
    赞同
    回复
  • 勾勾
    勾勾
    2019-09-11

    [132021058]您的操作已提交,请确认是否已生效。请问是什么原因?

    2019-09-11
    赞同
    回复
  • 汪攀
    汪攀
    2019-08-23

    商户未在当前申报的海关进行备案 CUSTOMS_UNREGISTERED 是什么原因呢

    2019-08-23
    赞同
    回复
  • 樊
    2019-08-16

    订单报关的时候, 返回 22001:支付企业编号(payCompanyCode)4403169D3W:支付企业名称(payCompanyName)财付通支付科技有限公司,需与企业备案时所填写名称一致 有谁碰到过这种情况吗

    2019-08-16
    赞同
    回复 1
    • 呆呆要翻天🙃
      呆呆要翻天🙃
      2019-11-28
      您们解决了这个问题了吗  麻烦指导一下
      2019-11-28
      回复
  • 南方
    南方
    2019-06-18

    guangzhou_zs代表总署应该写到接口文档里去,杭州、重庆,用地方代码,一个报不过去,提示商户未在当前申报的海关进行备案,一个报成功了但是审核没有对应支付单,真的是找哭了,找到这里看到贵州的例子才知道guangzhou_zs等于总署。

    2019-06-18
    赞同
    回复
  • dong|时米
    dong|时米
    2019-06-17

    Q11:提交报关接口返回以下错误:35311004,您的操作已提交,请确认是否已生效,这个错误是什么原因? 

    A11:请求参数name没有上传引起,身份信息的三个字段,要不三个字段都不传,要传就都传全才可以,请注意。

    我请求的参数中已经带有了name,还是返回这个问题。麻烦确认一下是什么原因?

    另外,我在交易的时候并没有上传身份信息。

    还有,我是用的服务商进行的交易


    我也是碰到这个问题,name参数肯定是有的

    2019-06-17
    赞同
    回复

正在加载...

登录 后发表内容