通用参数

序号 字段 名称 字段类型 必填 备注
1 goodsCategory 行业类目 String M 参见数据字典“行业类目”
2 userLoginId 商户用户登录名 String O 用户在商户系统中的登陆名（手机号、邮箱等标识）
3 userEmail 用户邮箱 String O 用户在商户系统中注册的邮箱
4 userMobile 绑定手机号 String O 商户系统中绑定手机号，如有，需要传送
5 registerUserName 用户注册姓名 String O
6 identifyState 是否实名认证 String O 1是 0不是
7 userIdNo 用户身份证号 String O
8 registerTime 注册时间 String O YYYYMMDDHHMMSS
9 registerIp 注册IP String O 用户在商户端注册时留存的IP
10 chName 持卡人姓名 String O
11 chIdNo 持卡人身份证号 String O
12 chCardNo 持卡人银行卡号 String O
13 chMobile 持卡人手机 String O
14 chPayIp 持卡人支付IP String M 持卡人在支付时的IP地址；如支付场景中，无法获取有效的持卡人IP，请直接传参127.0.0.1即可
15 deviceOrderNo 设备指纹订单号 String O 生成设备指纹的订单号(用于快捷)，如果和支付订单号一致，传相同的值
16 riskRateinfo 风险信息域 String M 签约支付H5绑卡、支付类场景必填

风险信息域riskRateinfo

序号 字段 字段名称 字段类型 必填项 备注
1 merUserRegDt 用户注册时间 String[14] M 格式：yyyyMMddHHmmss
2 usrLoginMethod 用户本次登录验证方式 String[5] M 位图形式，可扩展：11111;
3 usrLoginTime 用户本次登录时间 String[17] M 格式：yyyyMMddHHmmss
4 usrLoginMessageTime 用户在当前设备最近一次登录注册手机号 短信验证通过时间 String[17] M 格式：yyyyMMddHHmmss
5 usrLoginFaceTime 用户在当前设备最近一次人脸验证通过时间 String[17] M 格式：yyyyMMddHHmmss
6 usrLoginPasswordTime 用户在当前设备最近一次支付密码验证通过时间 String[17] M 格式：yyyyMMddHHmmss
7 deviceID 设备标识 String(1..64) M 移动终端设备的唯一标识
8 usrActivity 用户活跃度 String(1..3) M 用户最近一次打开应用服务 APP距今天数；数值范围：0-999。大于999天赋值999
9 usrFrequentAreaCode 用户常用地 String[4] M 6个月内打开应用服务方APP 时 GPS定位最多的城市，根据《银联卡跨行业务地区代码 标准》赋值 4 位数字
10 countryCode 国家代码 String[1..4] M 用户所在国家
11 districtCode 地区代码 String[1..6] M 用户所在地区
12 shippingProvinceCode 收货地址-省 String[6] C 直接支付、支付类场景必传有物流需按实际情况上送；无物流送默认值000000

电商

序号 字段 名称 字段类型 必填 备注
1 csName 收货人姓名 String M
2 csMobile 收货人手机 String M 不包含电话国家码的本地号码
3 csAreaCode 收货人区号 String O 如右边举例代表上海 021
4 csTel 收货人电话 String O 不包含电话国家码的本地固化号码
5 csIdType 收货人证件类型 String O 00-身份证；01-护照；02-军官证；03-士兵证；04-港澳台通行证；05-临时身份证；06-户口本；07-警官证；08-外国人居留证；09-回乡证；10-企业营业执照；11-法人代码证；12-台胞证；13-外交官证；14-文职干部或离休干部证明；15-学生证（16周岁以下未成年人）；99-其他
6 csIdNo 收货人证件号码 String O
7 csProvince 收货人省份 String M 参见我司省份代码
8 csCity 收货人城市 String M 参见我司城市代码
9 csAddress 收货人地址 String M 不包含国家、省份/州、城市信息的详细地址
10 prodNameList 商品名称 String M 多种商品，半角分号分隔
11 prodTypeList 商品类目 String M 多种商品规则同上
12 prodQtyList 商品数量 String M 多种商品规则同上
13 prodAmtList 商品总价 String M 数字 (15位总长度，2位小数)，多种商品规则同上
14 regAddress 会员注册信息中的地址 String O
15 prodUrl 商户url String O 商户产品的url
16 proPrice 商品单价 String M
17 logCompanyNumber 物流公司编号 String O
18 logOrderNo 物流单号 String M
19 sendDate 发货日期 String O YYYYMMDD
20 payerCountry 付款人所在国家 String O
21 saleMode 商户销售模式 String M 自营/非自营
22 accountId 抖音商户ID String O
23 shopName 店铺名称 String O

互金消金

序号 字段 名称 字段类型 必填 备注
1 tradeType 交易类型 String O 1-充值 2-还款 3-投标
2 customerType 用户类型 String O 1-投资人 2-借款人
3 hasBalance 商户会员账户是否有余额 String O 0-否 1-是
4 hasBindCard 商户会员是否绑定银行卡 String O 0-否 1-是
5 repaymentDate 到期还款日 String O 交易类型若为2 YYYYMMDDHHMMSS
6 lendingRate 借款利率 String O 交易类型若为2 例:10.5%
7 bidYields 标的收益率 String O 交易类型若为3 例:8.5%
8 latestTradeDate 账户前一次交易日期 String O 0-首次 YYYYMMDDHHMMSS

航旅

序号 字段 名称 字段类型 必填 备注
1 tbPName 乘机人姓名 String M 多个乘机人之间用半角分号分隔，例：张三;李四;王二
2 tbPTel 乘机人电话 String O 多个乘机人规则同上；FGW网关交易中与手机信息合并在该字段中
3 tbPMobile 乘机人手机 String M 多个乘机人规则同上
4 tbPEmail 乘机人邮箱 String M 多个乘机人规则同上
5 tbPIdType 乘机人证件类型 String M 00-身份证；01-护照；02-军官证；03-士兵证；04-港澳台通行证；05-临时身份证；06-户口本；07-警官证；08-外国人居留证；09-回乡证；10-企业营业执照；11-法人代码证；12-台胞证；13-外交官证；14-文职干部或离休干部证明；15-学生证（16周岁以下未成年人）；99-其他；多个乘机人规则同上
6 tbPIdNo 乘机人证件号码 String M 多个乘机人规则同上
7 tbPNantionality 乘机人国籍 Customer Nantionality String M 使用2位字母ISO代码；多个乘机人规则同上
8 tbPIsFrequenter 是否常旅客 String M N-否，Y-是；多个乘机人规则同上
9 tbFlight 航班号flight number String M
10 tbPTicketQty 机票数量 Quantity String M 正整数
11 tbTotalAmt 机票总价 Product Total Price （账单金额） String M 数字 (15位总长度，2位小数)
12 tbDetail1 机票细节1（航空公司）Product Detail1 (Airline Name) String M
13 tbDetail2 机票细节2（机票类座位等级）Product Detail2 (classes for arilines) String M
14 tbIsSingleTrip 是否单程 String M N-往返，Y-单程；
15 tbOffState 起飞国家 String M 国际ISO标准的2位字符国家名称
16 tbTagetState 目的国家 String M 国际ISO标准的2位字符国家名称
17 tbDepTime 起飞时间 String M YYYYMMDDhhmmss要求传输北京时间
18 tbDepAirport 起飞机场Departure Airport String M 参考国际航空运输协会（IATA）三位机场代码定义，例：PEK-北京市首都机场，SHA-上海市虹桥机场，PVG-上海市虹桥机场
19 tbArrivalAirport 降落机场 Arrival Airport String M 同上
20 tbTransitAirport 中转机场 Transit Airport String M 若有，格式标准同上；可支持多个中转机场，半角分号分隔
21 tbLeadtime 收发时间差 Lead Time 订票时间和登机时间的时间差，单位是天 String M
22 tbReceiptAddress 收取行程单地址 String O 如为国外地址为包含国家名称的详细地址

酒店

序号 字段 名称 字段类型 必填 备注
1 htGuestName 入住人姓名 String M 多个入住人之间用半角分号分隔，例：张三;李四;王二
2 htGuestPhone 入住人手机或电话 String M 多个入住人规则同上
3 htGuestIdType 入住人证件类型 String M 00-身份证；01-护照；02-军官证；03-士兵证；04-港澳台通行证；05-临时身份证；06-户口本；07-警官证；08-外国人居留证；09-回乡证；10-企业营业执照；11-法人代码证；12-台胞证；13-外交官证；14-文职干部或离休干部证明；15-学生证（16周岁以下未成年人）；99-其他；多个入住人规则同上
4 htGuestIdNo 入住人证件号码 String M 多个入住人规则同上
5 htBrand 酒店名称 String M
6 htLocalProvince 酒店所在省份 String M 参见我司省份代码
7 htLocalCity 酒店所在城市Nantionality String M 参见我司城市代码
8 htLocalStreet 酒店所在地址 String M 不包含国家、省份/州、城市信息的详细地址
9 htRoomType 房间类型 String M
10 htCheckinTime 入住起始时间 String M YYYYMMDDhhmmss
11 htCheckoutTime 入住终止时间 String M YYYYMMDDhhmmss

保险

序号 字段 名称 字段类型 必填 备注
1 applicantName 投保人姓名 String M
2 applicantAddr 投保人居住地址 String O
3 applicantIdCard 投保人身份证号码 String O
4 applicantMobile 投保人手机号 String M
5 insuredName 被保险人姓名 String O
6 insuredAddr 被保险人居住地址 String O
7 insuredIdCard 被保险人身份证号码 String O
8 insuredMobile 被保险人手机号 String O
9 beneficiaryName 受益人姓名 String O
10 beneficiaryAddr 受益人居住地址 String O
11 beneficiaryIdCard 受益人身份证号 String O
12 beneficiaryMobile 受益人手机号 String O
13 insuranceType 保险险种 String M
14 insuranceMoney 保额 String O
15 premium 保费 String O
16 payPeriod 缴费年限 String O

游戏

序号 字段 名称 字段类型 必填 备注
1 gameName 充值游戏名称 String M
2 userAcctId 游戏账户ID String M
3 rechargeType 充值类型 String M 0:为本账户充值或支付；1:为他人账户充值或支付；默认为 0
4 gameProdType 游戏商品类型 String M 01：点券类 02：金币类 03：装备道具类 04：其他
5 gameAcctId 被充值游戏账户ID String M 若充值类型为1
6 gameLoginTime 游戏登录次数 String M 累计最近一个月
7 gameOnlineTime 游戏在线时长 String M 累计最近一个月

大宗

序号 字段 名称 字段类型 必填 备注
1 btType 交易类型 String M 01：证券交易 02：期货交易 03：贵金属交易 04：期权交易 05：外汇交易 06：大宗商品交易 07：邮币卡
2 btUserIdType 用户注册证件类型 String O 00-身份证；01-护照；02-军官证；03-士兵证；04-港澳台通行证；05-临时身份证；06-户口本；07-警官证；08-外国人居留证；09-回乡证；10-企业营业执照；11-法人代码证；12-台胞证；13-外交官证；14-文职干部或离休干部证明；15-学生证（16周岁以下未成年人）；99-其他
3 btUserIdNo 用户注册证件号码 String M
4 btProvince 交易人省份 String M 参见我司省份代码
5 btCity 交易人城市 String M 参见我司城市代码
6 btAddress 交易人地址 String M 不包含国家、省份/州、城市信息的详细地址
7 btProdName 商品名称 String M
8 btAcctType 账户类型 String M 参见数据字典“帐户类型”

风控参数数据字典

商品类目（prodTypeList）

代码 中文名称(商品类型)
001 家用电器
002 手机/运营商/数码
003 电脑/办公
004 家居/家具/家装/厨具
005 男装/女装/童装/内衣
006 美妆个护/宠物
007 女鞋/箱包/钟表/珠宝
008 男鞋/运动/户外
009 汽车/汽车用品
010 母婴/玩具乐器
011 食品/酒类/生鲜/特产
012 礼品鲜花/农资绿植
013 医药保健/计生情趣
014 图书/音像/电子书
015 机票/酒店/旅游/生活
016 理财/众筹/白条/保险

行业类目（goodsCategory）

代码 中文名称(商品类目)
01 电商
02 互金消金
03 航旅
04 酒店
05 保险
06 游戏
07 大宗

证件类型

证件 编号
身份证 00
护照 01
军官证 02
士兵证 03
港澳台通行证 04
临时身份证 05
户口本 06
警官证 07
外国人居留证 08
回乡证 09
企业营业执照 10
法人代码证 11
台胞证 12
外交官证 13
文职干部或离休干部证明 14
学生证（16周岁以下未成年人） 15
其他 99

交易类型（btType）

代码 中文名称(交易类型)
04 证券交易
05 期货交易
06 贵金属交易
07 期权交易
08 外汇交易
09 大宗商品交易
10 邮币卡
11 其他

帐户类型（btAcctType）

代码 中文名称(帐户类型)
04 股票账户
05 基金帐户
06 大宗交易帐户（投资人帐户）
07 期货帐户
08 其他帐户

国家代码

编码 名称
AE 阿联酋(UNITED EMIRATES)
AF 阿富汗(AFGHANISTAN)
AL 阿尔巴尼亚(ALBANIA)
AM 亚美尼亚(ARMENIA)
AO 安哥拉(ANGOLA)
AR 阿根廷(ARGENTINA)
AT 奥地利(AUSTRIA)
AU 澳大利亚(AUSTRALIA)
AZ 阿塞拜疆(AZERBAIJAN(REPUBLIC))
BD 孟加拉(BANGLADESH)
BE 比利时(BELGIUM)
BF 布基纳法索(BURKINA FASO)
BG 保加利亚(BULGARIA)
BH 巴林(BAHREIN)
BI 布隆迪(BURUNDI)
BJ 贝宁(BENIN)
BL 巴勒斯坦()
BN 文莱(BRUNEI DARUSSALAM)
BO 玻利维亚(BOLIVIA)
BR 巴西(BRAZIL)
BW 博茨瓦纳(BOTSWANA)
BY 白俄罗斯(BYELORUSSIA)
CA 加拿大(CANADA)
CF 中非(CENTRAL AFRICA)
CG 刚果(CONGO)
CH 瑞士(SWITZERLAND)
CL 智利(CHILE)
CM 喀麦隆(CAMEROON)
CN 中国(CHINA)
CO 哥伦比亚(COLOMBIA)
CR 哥斯达黎加(COSTA RICA)
CS 捷克(CZECH REPUBIC)
CU 古巴(CUBA)
CY 塞浦路斯(CYPRUS)
DE 德 国(GERMANY)
DK 丹麦(DENMARK)
DO 多米尼加共和国(DOMINICAN REPUBLIC)
DZ 阿尔及利亚(ALGERIA)
EC 厄瓜多尔(ECUADOR)
EE 爱沙尼亚(ESTONIA)
EG 埃及(EGYPT)
ES 西班牙(SPAIN)
ET 埃塞俄比亚(ETHIOPIA)
FI 芬兰(FINLAND)
FJ 斐济(FIJI)
FR 法国(FRANCE)
GA 加蓬(GABON)
GB 英国(UNITED KINGDOM)
GD 格林纳达(GRENADA)
GE 格鲁吉亚(GEORGIA)
GH 加纳(GHANA)
GN 几内亚(GUINEA)
GR 希腊(GREECE)
GT 危地马拉(GUATEMALA)
HK 香港特别行政区(HONG KONG)
HN 洪都拉斯(HONDURAS)
HU 匈牙利(HUNGARY)
ID 印度尼西亚(INDONESIA)
IE 爱尔兰(IRELAND)
IL 以色列(ISRAEL)
IN 印度(INDIA)
IQ 伊拉克(IRAQ)
IR 伊朗(IRAN)
IS 冰岛(ICELAND)
IT 意大利(ITALY)
JM 牙买加(JAMAICA)
JO 约旦(JORDAN)
JP 日本(JAPAN)
KG 吉尔吉斯坦(KYRGYZSTAN)
KH 柬埔寨(KAMPUCHEA(CAMBODIA))
KP 北朝鲜(KOREA,DEM.PEOPLE’S)
KR 韩国(REPUBLIC OF KOREA)
KT 科特迪瓦共和国(COTE O’IVOIRE)
KW 科威特(KUWATI)
KZ 哈萨克(KAZAKHSTAN)
LA 老挝(LAOS)
LB 黎巴嫩(LEBANON)
LC 圣卢西亚(SAINT LUEIA)
LI 列支敦士登(LIECHTENSTEIN)
LK 斯里兰卡(SRI LANKA)
LR 利比里亚(LIBERIA)
LT 立陶宛(LITHUANIA)
LU 卢森堡(LUXEMBOURG)
LV 拉脱维亚(LATVIA)
LY 利比亚(LIBYAN)
MA 摩洛哥(MOROCCO)
MC 摩纳哥(MONACO)
MD 摩尔多瓦(MOLDOVA,REPUBLIC OF)
MG 马达加斯加(MADAGASCAR)
ML 马里(MALI)
MM 缅甸(BURMA(MYANMAR))
MN 蒙古(MONGOLIA)
MO 澳门地区(MACAU)
MT 马耳他(MALTA)
MU 毛里求斯(MAURITIUS)
MW 马拉维(MALAWI)
MX 墨西哥(MEXICO)
MY 马来西亚(MALAYSIA)
MZ 莫桑比克(MOZAMBIQUE)
NA 纳米比亚(NAMIBIA)
NE 尼日尔(NIGER)
NG 尼日利亚(NIGERIA)
NI 尼加拉瓜(NICARAGUA)
NL 荷兰(NETHERLANDS)
NO 挪威(NORWAY)
NP 尼泊尔(NEPAL)
NZ 新西兰(NEW ZEALAND)
OM 阿曼(OMAN)
PA 巴拿马(PANAMA)
PE 秘鲁(PERU)
PG 巴布亚新几内亚(PAPUA NEW GUINEA)
PH 菲律宾(PHILIPPINES)
PK 巴基斯坦(PAKISTAN)
PL 波兰(POLAND)
PT 葡萄牙(PORTUGAL)
PY 巴拉圭(PARAGUAY)
QA 卡塔尔(QATAR)
RO 罗马尼亚(ROMANIA)
RU 俄罗斯(RUSSIAN FEDERATION)
SA 沙特阿拉伯(SAUDI ARABIA)
SC 塞舌尔(SEYCHELLES)
SD 苏丹(SUDAN)
SE 瑞典(SWEDEN)
SG 新加坡(SINGAPORE)
SI 斯洛文尼亚(SLOVENIA)
SK 斯洛伐克(SLOVAKIA)
SM 圣马力诺(SAN MARINO)
SN 塞内加尔(SENEGAL)
SO 索马里(SOMALIA)
SY 叙利亚(SYRIA)
SZ 斯威士兰(SWAZILAND)
TD 乍得(CHAD)
TG 多哥(TOGO)
TH 泰国(THAILAND)
TJ 塔吉克斯坦(TAJIKISTAN)
TM 土库曼(TURKMENISTAN)
TN 突尼斯(TUNISIA)
TR 土耳其(TURKEY)
TW 台湾省(TAIWAN)
TZ 坦桑尼亚(TANZANIA)
UA 乌克兰(UKRAINE)
UG 乌干达(UGANDA)
US 美国(UNITED STATES)
UY 乌拉圭(URUGUAY)
UZ 乌兹别克(UZBEKISTAN)
VC 圣文森特岛(SAINT VINCENT)
VE 委内瑞拉(VENEZUELA)
VN 越南(VIET NAM)
YE 也门(YEMEN)
YU 南斯拉夫联盟(YUGOSLAVIA)
ZA 南非(SOUTH AFRICA)
ZM 赞比亚(ZAMBIA)
ZR 扎伊尔(ZAIRE)
ZW 津巴布韦(ZIMBABWE)

机场代码

参照国际航空运输协会规定的3位机场代码，国际通用代码，因此每家商户都一致。

省份，区域代码

参照我司省份、区域代码表 –>查看下载