文档中心 > API类目 > 淘宝游戏API

taobao.game.virtual.order.create (虚拟充值能力外放下单接口)

虚拟充值能力外放下单接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
ext String 可选 {"gasStation":"中国石化加油站(中旅望京站)","octaneRating":"97","oilGunNum":"001"} 扩展字段,如油站、油品、油枪号,json格式
biz_code String 必须 YP 业务类型,油品:YP
picture_url String 必须 http://www.pictureurl.com 商品图片地址
item_name String 必须 特惠加油#油站#油品#油枪号 商品名称
pay_price Number 必须 500 支付价格,单位分
account String 必须 13810002001 用户在商家侧账号
seller_id Number 必须 123321 卖家id
out_order_id String 必须 didi20200305101530 外部商家订单号

响应参数

名称 类型 示例值 描述
result VirtualTopResult 结果对象 结果对象
  • model
  • GameVirtualCreateOrderResponse
  • model为具体的业务结果
  • 业务返回结果对象
  • └ result_message
  • String
  • 成功
  • 业务结果描述
  • └ result_code
  • String
  • 0000
  • 接口执行结果:0000-成功; 0001-参数不合法;1001-创建淘宝订单失败;
  • └ alipay_order_id
  • String
  • 123123123123
  • 支付宝订单号
  • └ tb_order_id
  • String
  • 123123123
  • 淘宝订单号
  • └ out_order_id
  • String
  • didi20200305101530
  • 外部流水号
  • └ message
  • String
  • 接口处理成功
  • 接口执行结果描述
  • └ code
  • String
  • 0000
  • 接口执行结果码

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
GameVirtualOrderCreateRequest req = new GameVirtualOrderCreateRequest();
req.setExt("{\"gasStation\":\"中国石化加油站(中旅望京站)\",\"octaneRating\":\"97\",\"oilGunNum\":\"001\"}");
req.setBizCode("YP");
req.setPictureUrl("http://www.pictureurl.com");
req.setItemName("特惠加油#油站#油品#油枪号");
req.setPayPrice(500L);
req.setAccount("13810002001");
req.setSellerId(123321L);
req.setOutOrderId("didi20200305101530");
GameVirtualOrderCreateResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<game_virtual_order_create_response>
    <result>
        <model>
            <result_message>成功</result_message>
            <result_code>0000</result_code>
            <alipay_order_id>123123123123</alipay_order_id>
            <tb_order_id>123123123</tb_order_id>
            <out_order_id>didi20200305101530</out_order_id>
        </model>
        <message>接口处理成功</message>
        <code>0000</code>
    </result>
</game_virtual_order_create_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部