찾다

집 >위챗 애플릿 >위챗 개발 >WeChat 공개 플랫폼, WeChat 결제 통관 신고 인터페이스 개발

WeChat 공개 플랫폼, WeChat 결제 통관 신고 인터페이스 개발

高洛峰
高洛峰원래의
2017-03-08 16:49:054018검색

이 글에서는 위챗 결제 시 세관신고 인터페이스 개발 과정을 소개합니다. WeChat 세관 신고서는 판매자가 세관에서 요구하는 주문 정보를 제출하는 데 사용됩니다.

1. 관세 신고 인터페이스 API


인터페이스 주소

https://api.mch.weixin.qq.com/cgi-bin/mch/customs/customdeclareorder

증명서가 필요한가요?

아니요.


요청 방법: post 데이터 형식: xml 서명 방법: MD5

참고: 판매자의 주문 번호 금액은 주문 번호에 따라 달라집니다. 결제 시스템에 기록되어 있지 않습니다. 하위 주문 번호가 있는 경우 하위 주문의 결제 금액, 물류비, 상품 가격을 업로드해야 합니다. (결제 금액 = 물류비 + 상품 가격) .

판매자는 세관 등록 번호로 등록되어 있으며 관세는 NO가 아닙니다. 이 매개변수는 필수입니다.
필드 이름 변수 이름 필수 유형 예제 값 설명
서명 서명 예 String(32) C380BEC2BFD727A4B6845133519F3AD6 서명, 자세한 내용은 서명 생성 알고리즘 참조
공용 계정 ID appid is String(32) wxd678efh567hg6787 WeChat에서 할당한 공개 계정 ID
판매자 번호 mch_id 는 문자열(32) 1230000109 WeChat 결제로 할당된 판매자 번호
판매자 주문 번호 out_trade_no 예 String(32 ) 20150806125346 판매자 시스템 내 주문 번호
WeChat 결제 주문 번호 transaction_id td > 예 String(28) 1000320306201511078440737890 WeChat 결제에서 반환된 주문 번호
관세 관세 예 문자열(32) 상하이
字段名 变量名 必填 类型 示例值 说明
签名 sign 是 String(32) C380BEC2BFD727A4B6845133519F3AD6 签名，详见签名生成算法
公众账号ID appid 是 String(32) wxd678efh567hg6787 微信分配的公众账号ID
商户号 mch_id 是 String(32) 1230000109 微信支付分配的商户号
商户订单号 out_trade_no 是 String(32) 20150806125346 商户系统内部的订单号
微信支付订单号 transaction_id 是 String(28) 1000320306201511078440737890 微信支付返回的订单号
海关 customs 是 String(32) SHANGHAI

NO 无需上报海关

GUANGZHOU 广州

HANGZHOU 杭州

NINGBO 宁波

ZHENGZHOU_BS 郑州（保税物流中心）

CHONGQING 重庆

XIAN 西安

SHANGHAI 上海

ZHENGZHOU_ZH 郑州（综保区）

SHENZHEN 深圳
商户海关备案号 mch_customs_no 否 String(32) 123456 商户在海关登记的备案号，customs非NO，此参数必填
关税 duty 否 Int 888 关税，以分为单位
아니오 세관 신고 필요 없음

GUANGZHOU 광저우

HANGZHOU 항저우
字段名 变量名 必填 类型 示例值 描述
商户子订单号 sub_order_no 否 String(32) 20150806125346 商户子订单号，如有拆单则必传
币种 fee_type 否 String(3) CNY 微信支付订单支付时使用的币种，暂只支持人民币CNY,如有拆单则必传。
应付金额 order_fee 否 Int 888 子订单金额，以分为单位，不能超过原订单金额，order_fee=transport_fee+product_fee（应付金额=物流费+商品价格），如有拆单则必传。
物流费 transport_fee 否 Int 888 物流费用，以分为单位，如有拆单则必传。
商品价格 product_fee 否 Int 888 商品费用，以分为单位，如有拆单则必传。

닝보 닝보

ZHENGZHOU_BS 정저우(보세 물류 센터)

CHONGQING 충칭

字段名 变量名 必填 类型 示例值 描述
证件类型 cert_type 否 String(32) IDCARD 暂只支持身份证，该参数是指用户信息，商户若有用户信息，可上送，系统将以商户上传的数据为准，进行海关通关报备；
证件号码 cert_id 否 String(64) 330821198809085211 身份证号，该参数是指用户信息，商户若有用户信息，可上送，系统将以商户上传的数据为准，进行海关通关报备；
姓名 name 否 String(64) 张三 用户姓名，该参数是指用户信息，商户若有用户信息，可上送，系统将以商户上传的数据为准，进行海关通关报备；
XIAN 시안상하이 상하이ZHENGZHOU_ZH 정저우(종합보세구역)SHENZHEN 선전
판매자 세관 등록 번호 mch_customs_no 아니요 String(32) 123456
관세 관세 아니요 정수 888 관세, 단위로 구분됨
The 주문을 분할하거나 세관을 다시 신고할 때 다음 필드가 사용됩니다. 필수WeChat에 사용자 정보가 부족한 경우 다음 필드가 필요합니다. 판매자가 업로드한 경우. 사용자 정보에는 판매자가 업로드한 정보가 우선적으로 적용됩니다.

举例如下：

<xml>
   <appid>wx2421b1c4370ec43b</appid>
   <customs>ZHENGZHOU_BS</customs>
   <mch_customs_no>D00411</mch_customs_no>
   <mch_id>1262544101</mch_id>
   <order_fee>13110</order_fee>
   <out_trade_no>15112496832609</out_trade_no>
   <product_fee>13110</product_fee>
   <sign>8FF6CEF879FB9555CD580222E671E9D4</sign>
   <transaction_id>1006930610201511241751403478</transaction_id>
   <transport_fee>0</transport_fee>
   <fee_type>CNY</fee_type>
   <sub_order_no>15112496832609001</sub_order_no>
   </xml>

注：参数值用XML转义即可，CDATA标签用于说明数据不被XML解析器解析。


应答参数列表


字段名 变量名 必填 类型 示例值 说明
返回状态码 return_code 是 String(16) SUCCESS

SUCCESS/FAIL

此字段是通信标识，非交易标识，交易是否成功需要查看result_code来判断
返回信息 return_msg 否 String(128) 签名失败

返回信息，如非空，为错误原因

签名失败

参数格式校验错误

以下字段在return_code为SUCCESS的时候有返回

字段名 变量名 必填 类型 示例值 描述
签名类型 sign_type 是 String(32) MD5 暂只支持MD5
签名 sign 是 String(32) C380BEC2BFD727A4B6845133519F3AD6 签名，详见签名生成算法
公众账号ID appid 是 String(32) wxd678efh567hg6787 微信分配的公众账号ID
商户号 mch_id 是 String(32) 1230000109 微信支付分配的商户号
业务结果 result_code 是 String(16) SUCCESS SUCCESS/FAIL
错误代码 err_code 否 String(32) SYSTEMERROR 详细参见错误列表
错误代码描述 err_code_des 否 String(128) 系统错误 错误返回的信息描述

以下字段在return_code 和result_code都为SUCCESS的时候有返回

字段名 变量名 必填 类型 示例值 描述
状态码 state 是 String(2) UNDECLARED

状态码

UNDECLARED -- 未申报

SUBMITTED -- 申报已提交（订单已经送海关，商户重新申报，并且海关还有修改接口，那么记录的状态会是这个）

PROCESSING -- 申报中

SUCCESS -- 申报成功

FAIL-- 申报失败

EXCEPT --海关接口异常
微信支付订单号 transaction_id 是 String(28) 1000320306201511078440737890 微信支付返回的订单号
商户订单号 out_trade_no 是 String(32) 20150806125346 商户系统内部的订单号
商户子订单号 sub_order_no 否 String(32) 20150806125346 商户子订单号，如有拆单则必传
微信子订单号 sub_order_id 否 String(32) 20150806125346 微信子订单号
最后更新时间 modify_time 是 String(14) 20091227091010 最后更新时间，格式为yyyyMMddhhmmss，如2009年12月27日9点10分10秒表示为20091227091010。时区为GMT+8 beijing。该时间取自微信服务器


错误码


名称 描述 原因 解决方案
132011004 参数错误 报关时仅传入订单号，不传入子订单号（sub_order_no)时，不能填费用信息，须以支付系统中的值为准 请检查参数是否都正确
132021028 交易币种与商户结算币种不一致】 报关时传入子订单号（sub_order_no)时，币种参数（fee_type)必填 请检查所传币种参数（fee_type）是否为空
MCHID_NOT_SET 商户号未设置 商户号为必传参数，请求时必传 请检查商户号是否为空
MCHID_INVALID_LENGTH 无效的商户号长度 报关接口只支持12开头10位数字的商户号 请检查商户号长度是否为10位
CUSTOMSCONFIG_NOT_SET 海关配置未设置 报关接口需要商户已配置过海关信息才可以访问 请参照上文中的海关备案指引，进行海关信息报备
FEETYPE_NOT_SET 币种类型未设置 拆单情况下，币种为必填参数 请检查fee_type是否为空
OUTTRADENO_NOT_SET 商户订单号(out_trade_no)未设置 商户订单号为必传参数 请检查商户订单号(out_trade_no）是否为空
TRANSACTION_ID_NOT_SET 微信订单号(transaction_id)未设置 微信订单号(transaction_id)为必传参数 请检查微信订单号(transaction_id)是否为空
INVALID_TRANSACTION_ID 无效的微信订单号长度 微信订单号为28位数字，请确保长度一致 请检查微信订单号(transaction_id)是否正确
CUSTOMS_NOT_SET 海关信息未设置 海关信息为必传字段 请检查海关信息是否为空
CHCUSTOMSNO_NOT_SET 海关备案号未设置 海关备案号为必传字段 请检查备案号是否为空
INVALID_MCHCUSTOMSNO 无效的海关备案号长度 海关备案号一般为6位字符串 请检查海关备案号是否正确
PAYFEE_NOT_MATCH 金额不匹配 报关的订单金额必须和支付的金额一致 请检查报关订单的金额是否正确
INVALID_SUBORDER_NO 无效的子订单号长度(sub_order_no) 子订单号要求是32位以内的字符串 请检查子订单号长度是否正确
APPID_NOT_EXIST AppId未设置(sub_order_no) appid为必传字段 请检查appid是否正确
MCHID_NOT_EXIST 商户号(mch_id)未设置 MCH_ID为必传字段 请检查mch_id是否正确
AUTHORITY_NOT_FOUND 未开通自助清关功能 须先开通自助清关功能才可成功调用接口 请检查是否已开通自助清关功能，开通路径：微信支付商户平台-产品中心-自助清关中申请开通。
NO_AUTH 无权限 未获得此接口的调用权限 请检查当前商户号是否已获得此接口的调用权限

 

二、SDK实现

sdk定义

微信公众平台开发微信支付报关接口

微信公众平台开发微信支付报关接口

 

 

三、调用方式

微信公众平台开发微信支付报关接口

 

三、返回结果

发送数据如下

array(6) {
  ["appid"]=>
  string(18) "wxa8092dd025e45123"
  ["mch_id"]=>
  string(10) "1238298123"
  ["out_trade_no"]=>
  string(22) "SH20160824095750086988"
  ["transaction_id"]=>
  string(28) "4006742001201608242098415582"
  ["customs"]=>
  string(6) "NINGBO"
  ["mch_customs_no"]=>
  string(10) "3302461123"
}

接收到的数据如下

array(12) {
  ["return_code"]=>
  string(7) "SUCCESS"
  ["return_msg"]=>
  string(6) "成功"
  ["sign"]=>
  string(32) "91EFCEEAAD4322F331F3F63C4D8F1279"
  ["appid"]=>
  string(18) "wxa8092dd025e45123"
  ["mch_id"]=>
  string(10) "1238298123"
  ["result_code"]=>
  string(7) "SUCCESS"
  ["err_code"]=>
  string(1) "0"
  ["err_code_des"]=>
  string(2) "OK"
  ["state"]=>
  string(9) "SUBMITTED"
  ["transaction_id"]=>
  string(28) "4006742001201608242098415582"
  ["out_trade_no"]=>
  string(22) "SH20160824095750086988"
  ["modify_time"]=>
  string(14) "20160825111049"
}

 

위 내용은 WeChat 공개 플랫폼, WeChat 결제 통관 신고 인터페이스 개발의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!

성명：
본 글의 내용은 네티즌들의 자발적인 기여로 작성되었으며, 저작권은 원저작자에게 있습니다. 본 사이트는 이에 상응하는 법적 책임을 지지 않습니다. 표절이나 침해가 의심되는 콘텐츠를 발견한 경우 admin@php.cn으로 문의하세요.
이전 기사：WeChat 개발 사용자 정의 메뉴--weixin-java-tools다음 기사：WeChat 개발 사용자 정의 메뉴--weixin-java-tools

관련 기사

더보기