退出
热词搜索： 订单API 接口 查询退款订单 6五四三二一 appkey
API接口目录

平台业务

商品API
价格API
库存API
销售准备API
交易API
退货退款API（新）
店铺API
物流API
促销API
发票API
分销API
招商API
换货API
互动营销API
创新营销API
退货退款API
客服API
数据API
平台营销API
风控API
会员通API
账房API
财务记账API
异常码自查工具
suning.custom.virtual.get API单笔虚拟订单行查询服务
￥免费

通过此接口可进行单笔虚拟订单行的查询。
1、订单行号通过创建应用，对接suning_order_virtual_resend接口获取，此接口在消息文档-订单目录下。消息推送接口使用说明：http://open.suning.com/ospos/apipage/toDocContent.do?menuId=56；

2、订单号可通过接口“suning.custom.virtual.get”获取；
3、请求参数supplierCode商户编码、orderItemCode苏宁订单行号；
4、返回商户编码、苏宁订单行号、订单类型、苏宁商品编码、商家商品编码、购买数量、本次充值总金额、游戏账号、充值游戏编号、游戏区名称、游戏区编号、游戏服名称、游戏服编号；

公共参数
请求参数
名称 类型 是否必须 示例值 描述
orderItemCodeStringY101254223501苏宁订单行号
响应参数
名称 类型 示例值 描述
supplierCodeString70057494商家编码
orderCodeString10000011苏宁订单号
orderItemCodeStringorderItemCode苏宁订单行号
orderTypeString1订单类型
productCodeString108556757苏宁商品编码
itemCodeString1234A商家商品编码
cardNumString2购买数量
sumString999本次充值总金额，代表用户支付的金额
customerString1991.com充值账号（游戏卡号/手机充值号）
gameIdString901充值游戏编号（游戏品牌ID）
sectionNameString电信11去游戏区名称
sectionCodeString1101区编码
serverNameString紫禁之巅服务器名称
serverCodeString12345服编码
deviceIpString127.0.0.1充值IP地址
orderLineStatusString30订单行状态-0:订单取消；5:等待支付；10=待发货；15:发货中；20=已发货；30=交易成功；
returnFlagString1退款标记-1:退款中 2:退款成功 3:退货成功 正常订单返回空
rechargeTypeString游戏点数充值类型，例：游戏点数，点卡
roleNameString角色/角色ID角色名字段名称
roleCodeStringID123987/国服第一德莱文角色名字段取值
passNoNameStringQQ号/网易通行证/盛大通行证通行证字段名称
passNoCodeString81999240/81999240@qq.com通行证字段取值
orderSaletimeString2020-12-29 00:00:00订单销售时间
orderAccountString18581823119充值账号
mobilePhoneString185521823119手机号码
请求示例
  • XML示例
  • JSON示例
复制全部代码 
                                <sn_request>
  <sn_body>
    <getVirtual>
      <orderItemCode>101254223501</orderItemCode>
    </getVirtual>
  </sn_body>
</sn_request>

                                
                                {
  "sn_request": {
    "sn_body": {
      "getVirtual": {
        "orderItemCode": "101254223501"
      }
    }
  }
}
响应示例
  • XML示例
  • JSON示例
复制全部代码 
                              <sn_responseContent>
  <sn_body>
    <getVirtual>
      <deviceIp>127.0.0.1</deviceIp>
      <orderType>1</orderType>
      <orderSaletime>2020-12-29 00:00:00</orderSaletime>
      <passNoCode>81999240/81999240@qq.com</passNoCode>
      <itemCode>1234A</itemCode>
      <sectionCode>1101</sectionCode>
      <serverName>紫禁之巅</serverName>
      <sum>999</sum>
      <supplierCode>70057494</supplierCode>
      <sectionName>电信11去</sectionName>
      <returnFlag>1</returnFlag>
      <cardNum>2</cardNum>
      <roleCode>ID123987/国服第一德莱文</roleCode>
      <rechargeType>游戏点数</rechargeType>
      <orderLineStatus>30</orderLineStatus>
      <orderAccount>18581823119</orderAccount>
      <gameId>901</gameId>
      <passNoName>QQ号/网易通行证/盛大通行证</passNoName>
      <serverCode>12345</serverCode>
      <productCode>108556757</productCode>
      <mobilePhone>185521823119</mobilePhone>
      <orderItemCode>orderItemCode</orderItemCode>
      <roleName>角色/角色ID</roleName>
      <orderCode>10000011</orderCode>
      <customer>1991.com</customer>
    </getVirtual>
  </sn_body>
</sn_responseContent>

                              
                              {
  "sn_responseContent": {
    "sn_body": {
      "getVirtual": {
        "deviceIp": "127.0.0.1",
        "orderType": "1",
        "orderSaletime": "2020-12-29 00:00:00",
        "passNoCode": "81999240/81999240@qq.com",
        "itemCode": "1234A",
        "sectionCode": "1101",
        "serverName": "紫禁之巅",
        "sum": "999",
        "supplierCode": "70057494",
        "sectionName": "电信11去",
        "returnFlag": "1",
        "cardNum": "2",
        "roleCode": "ID123987/国服第一德莱文",
        "rechargeType": "游戏点数",
        "orderLineStatus": "30",
        "orderAccount": "18581823119",
        "gameId": "901",
        "passNoName": "QQ号/网易通行证/盛大通行证",
        "serverCode": "12345",
        "productCode": "108556757",
        "mobilePhone": "185521823119",
        "orderItemCode": "orderItemCode",
        "roleName": "角色/角色ID",
        "orderCode": "10000011",
        "customer": "1991.com"
      }
    }
  }
}
异常示例
  • XML示例
  • JSON示例
复制全部代码 

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
业务异常码
异常码 错误描述 解决方案
biz.custom.getvirtual.missing-parameter:* 参数必填 请检查此参数的值,*号表示参数字段名
biz.custom.getvirtual.format-error:* 参数格式错误 请检查此参数的值,*号表示参数字段名
biz.custom.getvirtual.length-overlong:* 参数的值超过规定长度 请检查此参数的值,*号表示参数字段名
biz.handler.data-get:no-result 查询没结果 请检查查询参数
isp.sys.service.unavailable.moms 服务不可用 请联系苏宁技术人员
公共异常码
API工具
API TOOLS 在线测试工具异常码查询工具SDK调用示例SDK下载
FAQ