淘宝开放平台

请求地址：

环境	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输入参数签名结果，签名算法介绍请点击这里。

名称	类型	是否必须	示例值	更多限制	描述
requestNo	String	必须	2019030411082312345678333	最大长度：64	请求编号 -最大长度64
bizNo	String	必须	201903041108231234567890	最大长度：64	天猫订单号-最大长度64
customerInfo	CustomerInfo	必须			客户信息
salary Money 必须月收入 └ unit String 必须 FEN 单位-最大长度32 └ currency String 必须 CNY 币种-最大长度32 └ amount Number 必须 666666 额度 └ company String 必须宇宙开发公司工作单位-最大长度64 └ certType String 必须 IDENTITY_CARD 证件类型：IDENTITY_CARD：身份证 PASSPORT：护照 └ address String 可选浙江杭州xx路xx小区 (身份证地址/常用地址) 未必有值-长度可变，DB设置text类型 └ mobile String 必须 133333333388 手机号-最大长度32 └ customerName String 必须高富帅客户姓名-最大长度32 └ certNo String 必须 39000000003330 证件号码-最大长度32 └ certValid String 必须 2020-02-03 证件有效期(格式yyyy-MM-dd),长期="2099-12-31"
carInfo	CarInfo	必须			车信息
└ series String 必须 X5 车系-最大长度32 └ brand String 必须宝马品牌(例如：本田、标致、宝马、路虎等)-最大长度32 └ tradeType String 必须 01 01-新车/02-二手车-最大长度32 fixedPrice Money 必须车一口价 └ unit String 必须 FEN 单位-最大长度32 └ currency String 必须 CNY 币种-最大长度32 └ amount Number 必须 32000000 额度-最大长度32 └ type String 必须 2016款雅阁混动 2.0L 锐酷版车型-最大长度32
cityId	String	必须	350500		提车城市编号-最大长度32
cityName	String	必须	泉州市		提车城市名称-最大长度32
creditAmount	Money	可选			资方终审额度
└ unit String 可选 FEN 单位-最大长度32 └ currency String 可选 CNY 币种-最大长度32 └ amount Number 可选 32000000 额度-最大长度32
storeId	String	必须	3393340311		天猫旗舰店id-最大长度32
storeName	String	必须	xx旗舰店		天猫旗舰店名称-最大长度64
itemId	String	必须	587438831238		天猫宝贝Id-最大长度32
capitalCode	String	必须	xx33		资方编码-最大长度32
capitalName	String	必须	民生银行		资方名称-最大长度64
bankBizNo	String	必须	333333		银行订单号:网商银行订单号-最大长度64
agreementAttachments	AgreementAttachmentDTO []	必须		最大列表长度：999	文件信息
└ fileName String 必须协议xxx 文件名称-最大长度64 └ filePath String 必须 http://db/d 文件路径-最大长度255 └ fileType String 必须 TCC_PERSON_USE_AUTHORIZER 业务对应定义-最大长度64 └ fileFormat String 必须 pdf 文件格式-最大长度32 └ number String 必须 DK-2023033-23 文件协议编号-最大长度32
customerId	String	必须	333333		客户id-最大长度32
customerType	String	必须	ALI		客户类型-最大长度32
itemName	String	必须	BMW X3 耀世版		天猫宝贝名称-最大长度1024
products	Product []	必须		最大列表长度：999	产品配置
└ appendMaxRatio String 必须 0.23 支持附加贷在车-价最高比例 ,小数点后2位，0.23 为 23%-最大长度32 └ penaltyInterestUpRatio String 必须 0.23 罚息上浮比例，小数点后2位，0.23 为 23%-最大长度32 └ discountInterestMin String 必须 0.082345 贴息后最低对客利率，小数点后6位eg 0.0823 是 8.2345%-最大长度32 maxAmount Money 必须 200000 最高贷款金额 └ amount Number 必须 100000 额度-最大长度32 └ currency String 必须 CNY 币种-最大长度32 └ unit String 必须 FEN 单位-最大长度32 minAmount Money 必须 100000 最低贷款金额 └ amount Number 必须 100000 额度-最大长度32 └ currency String 必须 CNY 币种-最大长度32 └ unit String 必须 FEN 单位-最大长度32 └ downPaymentMinRatio String 必须 0.35 最低首付比例数值，小数点后2位，例如0.35-最大长度32 └ rate String 必须 0.082356 年化小数点后6位，eg 0.0823 是 8.2356%-最大长度32 └ repaymentMethod String 必须 AVERAGE_CAPITAL_PLUS_INTEREST 还款方式，BALLOON_MORTGAGE=按期付息到期还本,AVERAGE_CAPITAL=等额本金,AVERAGE_CAPITAL_PLUS_INTEREST =等额本息-最大长度32 └ term Number 必须 24 贷款期数-最大长度32 └ priceGroup String 必须 A 定价分组-最大长度32 └ providerSimpleName String 必须大搜车金融服务商简称-最大长度32 └ providerCode String 必须 91330108MA27Y20J41 金融服务商代码-最大长度32 └ providerName String 必须浙江大搜车融资租赁有限公司金融服务商的名称-最大长度32 └ productName String 必须大搜车A24等额本息产品方案的名称-最大长度32 └ capitalType String 必须 BANK_DIRECT 资方模式，银行直投=BANK_DIRECT自有资金SELF-最大长度32 └ id String 必须 2001 产品方案id-最大长度32
discountAmountMax	Money	可选			最高贴息金额
└ currency String 可选 CNY 币种-最大长度32 └ amount Number 可选 100000 贴息金额-最大长度32 └ unit String 可选 FEN 单位-最大长度32
bankOutOrderNo	String	可选	3333		银行外部订单号:用于机构和网商联调时网商接口的入参OutOrderNo

名称	类型	示例值	描述
result	ResultDO		返回值
└ success Boolean true 业务正常执行 └ msgCode String 10000 响应码 10000：成功 10200：重复请求 10300：参数校验失败，10400：未知错误 10500：系统异常 10600：业务异常 10700：无权限访问 10800：状态不允许当前请求 └ msgDesc String 非法参数错误描述 └ retry Boolean false 是否可以重试 └ bizId String 2019009002 机构创建的内部单号

{"bizNo":"201903041108231234567890","bankBizNo":"333333","discountAmountMax":{"amount":100000,"unit":"FEN","currency":"CNY"},"customerInfo":{"certNo":"39000000003330","certType":"IDENTITY_CARD","address":"浙江杭州xx路xx小区","certValid":"2020-02-03","mobile":"133333333388","company":"宇宙开发公司","salary":{"unit":"FEN","amount":666666,"currency":"CNY"},"customerName":"高富帅"},"cityId":"350500","bankOutOrderNo":"3333","requestNo":"2019030411082312345678333","storeId":"3393340311","capitalCode":"xx33","products":[{"repaymentMethod":"AVERAGE_CAPITAL_PLUS_INTEREST","priceGroup":"A","minAmount":{"amount":100000,"unit":"FEN","currency":"CNY"},"capitalType":"BANK_DIRECT","providerCode":"91330108MA27Y20J41","downPaymentMinRatio":"0.35","providerSimpleName":"大搜车","appendMaxRatio":"0.23","penaltyInterestUpRatio":"0.23","productName":"大搜车A24等额本息","rate":"0.082356","discountInterestMin":"0.082345","term":24,"id":"2001","maxAmount":{"amount":100000,"unit":"FEN","currency":"CNY"},"providerName":"浙江大搜车融资租赁有限公司"}],"itemId":"587438831238","customerType":"ALI","itemName":"BMW X3 耀世版","capitalName":"民生银行","cityName":"泉州市","customerId":"333333","carInfo":{"series":"X5","type":"2016款 雅阁 混动 2.0L 锐酷版","brand":"宝马","fixedPrice":{"unit":"FEN","amount":32000000,"currency":"CNY"},"tradeType":"01"},"storeName":"xx旗舰店","agreementAttachments":[{"number":"DK-2023033-23","fileName":"协议xxx","filePath":"http://db/d","fileType":"TCC_PERSON_USE_AUTHORIZER","fileFormat":"pdf"}],"creditAmount":{"unit":"FEN","amount":32000000,"currency":"CNY"}}

{
    "result":{
        "success":true,
        "msgCode":"10000",
        "msgDesc":"非法参数",
        "retry":false,
        "bizId":"2019009002"
    }
}

{"result":{"msgDesc":"Illegal request","success":"false","msgCode":"sign-check-failure"}}

错误码	错误描述	解决方案

错误码查询工具 SDK下载

天猫汽车金融

qimen.tmall.fin.car.credit.apply (天猫汽车金融-提交第三方授信申请)

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ