IYUU.net

主题

B方案对接指引 最佳实践 ​

提示

根据公开数据，是中国境内对接耗时最短、性能稳定、开发成本最低的方案。

微信扫码登录 ​

用户中心 点击 “微信扫码登录” 按钮，使用微信扫一扫，完成登录。

创建应用 ​

  1. 进入 用户中心，点击 左侧菜单 中国海关 > 客户端控件 ，进入 应用管理 页面；
  2. 点击 创建应用 按钮，填写 中国电子口岸卡口令 ，并点击 确定 按钮；
  3. 刚才创建的 中国海关 应用，点击 其他 > 下载客户端 按钮，下载 中国电子口岸代理 客户端；
  4. 下载成功后，解压，并运行 IYUUProxy.exe 文件，完成初始化。
  5. 把 IYUUProxy.exe 添加到 启动项 中，方便 开机启动。
Windows 11 如何设置开机启动
  1. 按 Windows + R键，输入 shell:startup 后，点击确定，打开 启动文件夹
  2. 创建一个 快捷方式，指向 IYUUProxy.exe
  3. 把 快捷方式 拖到 启动文件夹

开发查验订单与回传订单接口 ​

提示

该接口请求方法必须同时支持 POST、PUT。

①获取查验订单信息 ​

信息

中国海关 发起订单查验时，IYUU.net 使用 POST 请求 电商平台 接口，拉取查验订单的支付信息，加签后上报给海关；

  • 请求方法：POST
  • Content-Type：application/json; charset=utf-8
  • 调用方：IYUU.net

请求Header参数 ​

参数名类型必填说明
AuthorizationStringY请求验证参数

示例值：Authorization: app_id=应用ID&timestamp=秒时间戳&signature=签名值

bodyString 表示请求Body参数的JSON字符串。

signature 签名算法：md5(app_id + app_secret + timestamp + bodyString)。

请求Body参数 ​

参数名类型必填说明
orderNoStringY申报订单的订单编号
sessionIDStringY海关发起请求时，平台接收的会话ID
serviceTimeLongY调用时的系统毫秒时间戳

示例值：

json
{
  "orderNo": "cp514512029621420032",
  "sessionID": "10000",
  "serviceTime": 1764038429000
}

响应参数 ​

参数名类型必填说明
codeIntY响应码（0成功）
msgStringY错误描述信息
dataObjectY响应数据
data.orderNoStringY申报订单的订单编号
data.sessionIDStringY海关发起请求时，平台接收的会话ID
data.serviceTimeLongY调用时的系统毫秒时间戳
data.payExchangeInfoHeadObjectY支付原始数据表头
data.payExchangeInfoListListY支付原始数据表体

示例值：

json
{
  "code": 0,
  "msg": "success",
  "data": {
    "orderNo": "cp514512029621420032",
    "sessionID": "10000",
    "serviceTime": "1764037961426",
    "payExchangeInfoHead": {
      "guid": "IYUUD9DA93617BC3F967B16FA72DEF123FFB",
      "initalRequest": "<xml><openid><![CDATA[o9dVx7UNVlJOriLvvWikckOcRXZk]]></openid><out_trade_no><![CDATA[cp514512029621420032]]></out_trade_no><total_fee>28900</total_fee><attach><![CDATA[product]]></attach><body><![CDATA[IYUU--IYUU BioSkin 赋活隔....]]></body><trade_type><![CDATA[JSAPI]]></trade_type><notify_url><![CDATA[https://xxx.cn/api/pay/notify/routine]]></notify_url><spbill_create_ip><![CDATA[180.98.36.230]]></spbill_create_ip><appid><![CDATA[wxff7ddeae4a59f857]]></appid><mch_id>1695916432</mch_id><nonce_str><![CDATA[691ef1b3c28a2]]></nonce_str><sign><![CDATA[41E9839BAC96F5B17C221FFA7286B9AB]]></sign></xml>",
      "initalResponse": "ok",
      "ebpCode": "000000",
      "payCode": "4403169D3W",
      "payTransactionId": "4200002960202511202675157859",
      "totalAmount": 289,
      "currency": "142",
      "verDept": "2",
      "payType": "4",
      "tradingTime": "20251120184754",
      "note": "备注"
    },
    "payExchangeInfoLists": [
      {
        "orderNo": "cp514512029621420032",
        "goodsInfo": [
          {
            "gname": "IYUU BioSkin 赋活隔离美肌乳 30mL",
            "itemLink": "https://xxx.com/pages/goods_details/index?id=25"
          }
        ],
        "recpAccount": "000000",
        "recpCode": "000000",
        "recpName": "海南跨境电子商务有限公司"
      }
    ]
  }
}

②回传订单查验结果 ​

信息

中国海关 发起订单查验时，IYUU.net 使用 PUT 请求 电商平台 接口，回传订单的查验结果。

  • 请求方法：PUT
  • Content-Type：application/json; charset=utf-8
  • 调用方：IYUU.net

请求Header参数 ​

参数名类型必填说明
AuthorizationStringY请求验证参数

示例值：Authorization: app_id=应用ID&timestamp=秒时间戳&signature=签名值

bodyString 表示请求Body参数的JSON字符串。

signature 签名算法：md5(app_id + app_secret + timestamp + bodyString)。

请求Body参数 ​

示例值：

json
{
  "orderNo": "cp514512029621420032",
  "sessionID": "10000",
  "serviceTime": 1764038429000,
  "payload": {
    "signValue": "yAJa3X1tgznOeTLEvNIzAXGvu4AADqTtCLQYlsQQK9ZNt1NW5Uv25H35rLeHeHJ+h7/fWSbdO1ZCsICCaBWdyg==",
    "certNo": "00027ceb",
    "upload_status": "PUSH_ERROR",
    "upload_result": {
      "code": "20006",
      "message": "上传失败,入库失败: 唯一标识sessionID重复",
      "total": 0,
      "serviceTime": 1764038433497
    }
  }
}

响应参数 ​

参数名类型必填说明
codeIntY响应码（0成功）
msgStringY错误描述信息
dataObjectN响应数据

示例值：

json
{
  "code": 0,
  "msg": "success",
  "data": []
}

查验状态变更流程图 ​

中国海关179订单查验状态变更流程图