附录

1.业务应答码

错误码 含义
0000 交易成功
BF00436 交易类型不存在
BF00121 报文交易要素格式错误
BF00123 商户不存在或状态不正常，请联系宝付
BF00116 该终端号不存在
BF00124 商户与终端号不匹配
BF00316 ip未绑定，请联系宝付
BF00313 该商户未开通此产品
BF00100 系统异常，请联系宝付
BF00450 签名验证失败
BF00437 不支持的密钥类型
BF00118 报文中密文解析失败
BF00331 卡号校验失败
BF00438 不支持的卡类型
BF00322 卡类型和卡号不匹配
BF00190 商户流水号不能重复
BF00101 持卡人信息有误
BF00111 交易失败
BF00112 系统繁忙，请稍后再试
BF00113 交易处理中，请稍后查询
BF00249 订单已过期，请使用新的订单号发起交易
BF00105 短信验证码错误
BF00106 短信验证码失效
BF00258 手机号码校验失败
BF00261 短信验证码错误次数超限，请重新获取
BF00260 短信验证码已过期，请重新发送
BF00107 当前银行卡不支持该业务，请联系发卡行
BF00108 交易失败，请联系发卡行
BF00140 该卡已被注销
BF00141 该卡已挂失
BF00237 该卡已冻结，请联系发卡行
BF00236 卡号无效，请确认后输入
BF00327 请联系银行核实您的卡状态是否正常
BF00332 交易失败，请重新支付
BF00343 验证失败（手机号有误）
BF00346 验证失败（身份证号有误）
BF00347 交易次数频繁，请稍后重试
BF00355 验证失败（卡状态异常）
BF00202 交易超时，请稍后查询
BF00135 交易金额不正确
BF00134 绑定关系不存在
BF00127 不支持该支付通道的交易
BF00114 订单已支付成功，请勿重复支付
BF00249 订单已过期，请使用新的订单号发起交易
BF00126 该笔订单已存在
BF00136 订单创建失败
BF00342 单卡单日余额不足次数超限
BF08704 单笔金额超限，该银行单笔可支付{}元！
BF00325 目前该银行正在维护中，请更换其他银行卡支付
BF08703 支付金额需大于最低限额{}元！
BF00234 单日交易金额超限！
BF00255 发送短信验证码失败
BF00128 该笔订单不存在
BF00262 交易金额与扣款成功金额不一致，请联系宝付
BF00103 账户余额不足
BF00104 交易金额超限
BF00235 单笔交易金额超限
BF00421 持卡人已与银行解绑，请重新绑卡后再进行支付！
BF00422 该用户信息发生变更，请重新绑卡
BF00334 分账信息格式不正确
BF00335 分账参数验证失败
BF00336 分账信息和之前不一致
BF00337 分账指令已经受理
BF00338 分账成功
BF00339 已分账
BF00423 绑卡失败，请重新签约
BF00376 该笔交易，扣款已成功，待分账
BF00110 该卡暂不支持此交易
BF00468 该母订单已确认，请勿重复确认
BF00469 母订单状态非待确认状态
BF00470 订单待确认
BF00480 订单超时失败

2.银行编码

银行代码 银行名称
ICBC 中国工商银行
ABC 中国农业银行
CCB 中国建设银行
BOC 中国银行
BCOM 中国交通银行
CIB 兴业银行
CITIC 中信银行
CEB 中国光大银行
PAB 平安银行
PSBC 中国邮政储蓄银行
SHB 上海银行
SPDB 浦东发展银行
CMBC 中国民生银行
CMB 招商银行
GDB 广发银行
HXB 华夏银行
HZB 杭州银行
BOB 北京银行
NBCB 宁波银行
JSB 江苏银行
ZSB 浙商银行

3.交易类型枚举

交易类型 交易描述
140 合并支付预绑卡类交易
141 合并支付确认绑卡类交易
03 查询绑定关系类交易
04 协议支付解除绑卡类交易
07 母订单查询类交易
19 分账(母单对应子单)订单状态查询类交易
137 母订单支付交易类
138 子订单支付交易类
139 子订单支付结果查询交易类
168 母单组合营销支付交易类

4.商户接口枚举类型

A1、卡类型- card_type

类型编码 含义
101 借记卡
102 信用卡

A2、证件类型- id_card_type

类型编码 含义
01 身份证
12 港澳居民居住证
13 台湾居民居住证

5.商户接口应答码

应答码 含义
S 成功
F 失败
I 处理中
FF 失败（支付结果查询类交易才会返回，表示订单查询参数错误或其他原因导致的订单查询失败，而非订单交易失败）

风控参数字段说明

通用参数

序号 域名 变量名 字段类型 必填 备注
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 生成设备指纹的订单号(用于快捷)，如果和支付订单号一致，传相同的值

电商

序号 域名 变量名 字段类型 必填 备注
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

互金消金

序号 域名 变量名 字段类型 必填 备注
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位机场代码，国际通用代码，因此每家商户都一致。

省份，区域代码

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

作者：xiaofeng  创建时间：2024-03-21 18:08
最后编辑：xiaofeng  更新时间：2025-01-09 17:41