淘宝开放平台

请求地址：

环境	HTTP请求地址
正式环境	http://qimen.api.taobao.com/router/qm
测试环境	http://qimen.api.taobao.com/router/qmtest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
customerId	String	是	WMS颁发给用户的ID
sign_method	String	是	签名的摘要算法，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。

名称	类型	是否必须	示例值	更多限制	描述
seller	Seller	必须			卖家信息
└ store_name String 可选 sfdsf 门店名 └ employee_id String 可选 123123 员工Id └ enterprise_id String 必须 123123 企业Id └ store_id String 可选 1231 门店Id
general	General	必须			一般信息
└ booking_date Number 可选 12312312 预定配装时间，时间戳 └ ihome_trade_version Number 必须 1 交易系统版本 └ main_order_id String 必须 2321312 ihome主订单Id └ project_id String 可选 12321 ihome项目Id └ share_commission Boolean 可选 true 是否分佣
promotions	Promotion []	可选		最大列表长度：999999	优惠列表
└ amount Number 必须 1000 优惠金额，分 └ cost Number 可选 100 成本金额，分 └ title String 可选 test 优惠标题
price_info	PriceInfo	必须			价格信息
└ pay_price Number 必须 12312312 实付价格，分 └ adjust_fee Number 可选 1231232 优惠减免，分 └ total_price Number 必须 120 订单总价, 分
item_based_orders	ItemBasedSubOrder []	可选		最大列表长度：999999	基于商品的子订单列表
└ pay_price Number 必须 1234 子订单实付价格，分 └ item_id String 必须 12 商品Id └ sub_order_id String 必须 12321 子订单id └ total_price Number 必须 123123 子订单总价，分 └ count Number 必须 123 商品数量 └ sku_id String 必须 0 商品skuId，没有则为0 └ adjust_fee Number 可选 100 优惠分摊，分 └ type String 可选 TEST 类型 └ partner_item_attachment_id String 可选 1111 外部附加Id
partner_based_orders	PartnerBasedSubOrder []	可选		最大列表长度：999999	基于合作方订单的子订单
└ pay_price Number 必须 1234 子订单实付价格，分 └ sub_order_id String 必须 12312 子订单Id └ partner_sub_id String 必须 123123 合作方子订单id └ total_price Number 必须 123123 子订单总价，分 └ count Number 必须 123 商品数量 └ adjust_fee Number 可选 100 优惠分摊 └ type String 可选 TEST 类型 └ itemId String 可选 123 商品Id └ skuId String 可选 11 skuId
material_based_orders	MaterialBasedSubOrder []	可选		最大列表长度：999999	基于商家编码的子订单
└ pay_price Number 必须 1234 子订单实付价格，分 └ sub_order_id String 必须 12321 子订单Id └ total_price Number 必须 123123 子订单原价，分 └ count Number 必须 123 商品数量 └ materiel_id String 必须 12 商品商家编码 └ adjust_fee Number 可选 100 优惠分摊，分 └ type String 可选 TEST 类型
buyer	Buyer	必须			买家信息
address Address 可选收货地址 └ district_code String 可选 3 区code └ district_name String 可选五常区名 └ city_name String 可选杭州城市名 └ city_code String 可选 2 城市code └ street_name String 可选文一西路街道名 └ street_code String 可选 5 街道code └ province_code String 可选 1 身份code └ province_name String 可选浙江省名 └ address String 可选 test 详细地址 └ phone String 可选 1231231 手机号 └ sex String 可选 1 性别 └ name String 可选 xxxx 姓名
_REQ_ID	String	可选	123123		请求id
pay_list	PayInfo []	必须		最大列表长度：999	支付信息
└ no String 必须 111 流水 └ amount Number 必须 1000 金额，分 └ time String 必须 11111 时间戳 └ type String 必须 POS 支付类型：POS/支付宝等 └ phase String 必须 FULL 支付阶段：FULL：全款 FIRST：首付 LAST：尾款

名称	类型	示例值	描述
success	Boolean	true	接口是否成功
error_code	String	PARAM_ERROR	错误时的业务错误码
error_message	String	param error	错误时的业务错误信息
data	Data		返回值
sub_order_entries PartnerSubOrderEntry [] 合作方的子订单列表 └ partner_sub_id String 1231 合作方子订单Id └ sub_order_id String 1231 对应的ihome子订单Id └ partner_main_id String 123 合作方的主订单Id
biz_success	Boolean	true	业务结果是否成功

{"seller":{"store_id":"1231","employee_id":"123123","store_name":"sfdsf","enterprise_id":"123123"},"price_info":{"pay_price":12312312,"total_price":120,"adjust_fee":1231232},"general":{"project_id":"12321","booking_date":12312312,"ihome_trade_version":1,"share_commission":true,"main_order_id":"2321312"},"partner_based_orders":[{"itemId":"123","pay_price":1234,"total_price":123123,"adjust_fee":100,"count":123,"partner_sub_id":"123123","sub_order_id":"12312","type":"TEST","skuId":"11"}],"promotions":[{"amount":1000,"cost":100,"title":"test"}],"item_based_orders":[{"pay_price":1234,"total_price":123123,"item_id":"12","adjust_fee":100,"count":123,"partner_item_attachment_id":"1111","sku_id":"0","sub_order_id":"12321","type":"TEST"}],"pay_list":[{"phase":"FULL","no":"111","amount":1000,"time":"11111","type":"POS"}],"material_based_orders":[{"pay_price":1234,"total_price":123123,"materiel_id":"12","adjust_fee":100,"count":123,"sub_order_id":"12321","type":"TEST"}],"_REQ_ID":"123123","buyer":{"address":{"district_name":"五常","city_name":"杭州","address":"test","district_code":"3","city_code":"2","province_code":"1","street_code":"5","street_name":"文一西路","province_name":"浙江"},"phone":"1231231","sex":"1","name":"xxxx"}}

{
    "success":true,
    "error_code":"PARAM_ERROR",
    "error_message":"param error",
    "data":{
        "sub_order_entries":[
            {
                    "partner_sub_id":"1231",
                    "sub_order_id":"1231"
            }
        ],
        "partner_main_id":"123"
    },
    "biz_success":true
}

{"error_message":"Illegal request","success":"不等于true","error_code":"sign-check-failure"}

错误码	错误描述	解决方案

错误码查询工具 SDK下载

交易API

qimen.alibaba.ihome.ctom.trade.pay.advance.sync (订单支付同步)

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ