退出
热词搜索：
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