文档中心 > API类目 > 交易API

qimen.alibaba.uni.trade.precreate (全域收单交易预创建接口)

预下单接口，该接口可返回待交易商品交易金额，以及可以享受的优化，以及折后实付

公共参数

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://gw.api.taobao.com/router/rest	https://eco.taobao.com/router/rest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
target_app_key	String	否	被调用的目标AppKey，仅当被调用的API为第三方ISV提供时有效。
sign_method	String	是	签名的摘要算法，可选值为：hmac，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。
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。
partner_id	String	否	合作伙伴身份标识。
simplify	Boolean	否	是否采用精简JSON返回格式，仅当format=json时有效，默认值为：false。

请求参数

名称	类型	是否必须	示例值	更多限制	描述
storeId	String	可选	100004		门店ID。
goodsList	RcGoodsParam []	必须		最大列表长度：999	商品列表，列表元素格式为：商品标识:商品数量
└ goodsId String 必须 69534523423 商品标识 └ quantity String 必须 1 商品数量，支持浮点。唯一码模式下固定为1 └ price Number 可选 13850 商品价格，单位：分（人民币） └ idType String 必须 CUSTOM 商品标识类型。UNIQUE：唯一码；ITEM_SKU：sku模式；CUSTOM：商家自有编码 └ guider String 可选 9527 导购员编号 └ outSubTradeNo String 可选 OTS5435643 商品所属外部子单号
storeIdType	String	可选	RPLUS		门店Id类型，RPLUS：零售+门店ID; PLACE：商户中心门店ID; CUSTOM：自有门店ID，须在商户中心有映射关系

响应参数

名称	类型	示例值	描述
success	Boolean	true	业务失败或成功 true\|false
errCode	String	20887	错误码
errMsg	String	无效参数	错误信息
data	RcTradePreCreateDTO		业务数据
└ totalAmount String 15000 商品总金额，单位：分（人民币） └ actualPayAmount String 10000 实付金额，单位：分（人民币） goodsList RcGoods [] 商品详情列表 └ goodsId String 69534523423 商品标识 └ quantity String 1 商品数量，支持浮点。唯一码模式下固定为1 └ price Number 13850 商品价格，单位：分（人民币） └ idType String CUSTOM 商品标识类型。UNIQUE：唯一码；ITEM_SKU：sku模式；CUSTOM：商家自有编码 └ itemId Number 4354355 itemId └ skuId Number 12321431 skuId └ title String 如意金箍棒商品标题 └ storeId String 100004 门店ID └ saleable Boolean true 是否可售卖(预下单有效) └ reason String 已售出不可售卖的原因(预下单有效) └ originPrice Number 13850 商品原价 └ guider String 9527 导购员编号
promotionList	RcPromotion []		权益列表
└ promotionId Number 45346547 零售核心权益标识 └ promotionTitle String 满100减10 零售核心权益标题 └ promotionDesc String 不可叠加使用零售核心权益描述 └ deductedAmount Number 1000 对应权益扣减的金额，单位：分（人民币） └ type Number true 权益类型 0：平台权益 1：外部权益默认为1

请求示例

JAVA
.NET
PHP
CURL
Python
C/C++
NodeJS

QimenCloudClient client = new DefaultQimenCloudClient(url, appkey, secret);
AlibabaUniTradePrecreateRequest req = new AlibabaUniTradePrecreateRequest();
req.setStoreId("100004");
List<AlibabaUniTradePrecreateRequest.RcGoodsParam> list2 = new ArrayList<AlibabaUniTradePrecreateRequest.RcGoodsParam>();
AlibabaUniTradePrecreateRequest.RcGoodsParam obj3 = new AlibabaUniTradePrecreateRequest.RcGoodsParam();
list2.add(obj3);
obj3.setGoodsId("69534523423");
obj3.setQuantity("1");
obj3.setPrice(13850L);
obj3.setIdType("CUSTOM");
obj3.setGuider("9527");
obj3.setOutSubTradeNo("OTS5435643");
req.setGoodsList(list2);
req.setStoreIdType("RPLUS");
AlibabaUniTradePrecreateResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

XML示例
JSON示例

<success>true</success>
<errCode>20887</errCode>
<errMsg>无效参数</errMsg>
<data>
    <totalAmount>15000</totalAmount>
    <actualPayAmount>10000</actualPayAmount>
    <goodsList>
        <rc_goods>
            <goodsId>69534523423</goodsId>
            <quantity>1</quantity>
            <price>13850</price>
            <idType>CUSTOM</idType>
            <itemId>4354355</itemId>
            <skuId>12321431</skuId>
            <title>如意金箍棒</title>
            <storeId>100004</storeId>
            <saleable>true</saleable>
            <reason>已售出</reason>
            <originPrice>13850</originPrice>
            <guider>9527</guider>
        </rc_goods>
    </goodsList>
</data>
<promotionList>
    <rc_promotion>
        <promotionId>45346547</promotionId>
        <promotionTitle>满100减10</promotionTitle>
        <promotionDesc>不可叠加使用</promotionDesc>
        <deductedAmount>1000</deductedAmount>
        <type>true</type>
    </rc_promotion>
</promotionList>

异常示例

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测试工具错误码查询工具 SDK下载

如何获得此API

FAQ

我要提问

返回
顶部