KYC 开卡

KYC 开卡流程图

[第一步].KYC 开卡(2026.1.14废弃，开卡使用v2接口)

{
  "status": 200,
  "msg": "ok",
  "extend": {
      "date": "2025-05-29 11:22:35",
      "unique": "6837d2fb73e4f258874405",
      "runtime": "72.72 ms"
  },
  "data": {
      "item_id": 10007,
      "card_pool_id": 10374,
      "total_amount": "0.19000000",
      "client_order_no": "111111125",
      "vendor_order_no": ""
  },
  "microtime": 1748488955547
}

返回的 card_pool_id 是卡片的唯一标识符，需要保存，其他接口会使用到

HTTP请求:

GET /kycOpenCard

请求参数

参数	取值	必传	类型	备注
公共请求参数...
user_id	1000001	是	string	自定义用户ID
user_card_id	1000001	否	string	自定义用户卡ID
client_order_no	TP1718204900991221760	是	string	自定义订单号 (不可重复)
vendor_card_id	1000009	是	int	卡类型ID
preferred_card_name	John Martin Doe	是	string	要打印在物理卡上的名称
cardholder_first_name	John	是	string	名
cardholder_surname	Doe	是	string	姓
dial_code	81	是	string	手机区号(限制国家区号列表详见附件)
phone_number	9087645678	是	string	手机号码
date_of_birth	1985/01/01	是	string	出生日期，格式YYYY/MM/DD
id_type	1	是	int	身份证件类型: 1 = passport,2 = health,3 = national id,4 = tax id number,5 = social security number,6 = driving license
id_number	7486758939829	是	string	证件类型对应的ID号
id_country	SG	是	string	发证国家地区(Alpha-2代码)(限制国家列表详见附件)
issuance_date	2025/01/01	是	string	发证日期，格式YYYY/MM/DD
expiration_date	2035/01/01	是	string	证件有效期，格式YYYY/MM/DD
card_is_primary	true	是	布尔值	是否为主卡
country	SG	是	string	国家地区(Alpha-2代码)(限制国家列表详见附件)
region	Singapore	是	string	地区
city	Singapore	是	string	城市
street	79 Ayer Rajah Crescent	是	string	街道
house	#04/08	是	string	门牌号
postal_code	139955	是	string	邮编
email	example@gmail.com	否	string	邮箱
card_type	virtual	否	string	废弃 - 卡类型 physical 物理卡 ,virtual虚拟卡（默认）

受风控条件考虑废弃虚拟卡升级物理卡流程，请在开卡前选定好您要开物理卡还是虚拟卡参考商户已开通卡列表;
card_type 废弃请使用 vendor_card_id 分为虚拟卡 / 实体卡

返回结构

参数	示例值	说明/备注
tx_item_id	10007	结算数字货币ID
total_amount	"0.19000000"	开卡手续费
card_pool_id	10374	卡池 ID
client_order_no	TP1718204900991221760	自定义订单号
vendor_order_no	""	卡商交易 ID

[第一步].KYC 开卡 V2

{
  "status": 200,
  "msg": "ok",
  "extend": {
      "date": "2025-05-29 11:22:35",
      "unique": "6837d2fb73e4f258874405",
      "runtime": "72.72 ms"
  },
  "data": {
      "item_id": 10007,
      "card_pool_id": 10374,
      "total_amount": "0.19000000",
      "client_order_no": "111111125",
      "vendor_order_no": ""
  },
  "microtime": 1748488955547
}

返回的 card_pool_id 是卡片的唯一标识符，需要保存，其他接口会使用到

HTTP请求:

GET /v2/kycOpenCard

请求参数

参数	取值	必传	类型	备注
公共请求参数...
user_id	1000001	是	string	自定义用户ID
user_card_id	1000001	否	string	自定义用户卡ID
client_order_no	TP1718204900991221760	是	string	自定义订单号 (不可重复)
vendor_card_id	1000009	是	int	卡类型ID
preferred_card_name	John Martin Doe	是	string	要打印在物理卡上的名称
cardholder_first_name	John	是	string	名
cardholder_surname	Doe	是	string	姓
dial_code	81	是	string	手机区号(限制国家区号列表详见附件)
phone_number	9087645678	是	string	手机号码
date_of_birth	1985/01/01	是	string	出生日期，格式YYYY/MM/DD
email	example@gmail.com	是	string	邮箱
id_type	1	是	int	身份证件类型: 1 = passport,2 = health,3 = national id,4 = tax id number,5 = social security number,6 = driving license
id_number	7486758939829	是	string	证件类型对应的ID号
id_country	SG	是	string	发证国家地区(Alpha-2代码)(限制国家列表详见附件)
card_is_primary	true	是	布尔值	是否为主卡
country	SG	是	string	国家地区(Alpha-2代码)(限制国家列表详见附件)
region	Singapore	是	string	地区
city	Singapore	是	string	城市
street	79 Ayer Rajah Crescent	是	string	街道
house	#04/08	是	string	门牌号
postal_code	139955	是	string	邮编
provider	1	是	int	kyc提供商：1=sumsub;2=myinfo;3=jumio;4=didit;5=shufti
reference_id	680624264232c620236627	是	string	kyc提供商编号ID：需大于最少10个字符
stock_keeping_code	QFX9AVML	否	string	白卡的 sku 编号，传了就是使用指定的白卡去开卡符

受风控条件考虑废弃虚拟卡升级物理卡流程，请在开卡前选定好您要开物理卡还是虚拟卡参考商户已开通卡列表;
card_type 废弃请使用 vendor_card_id 分为虚拟卡 / 实体卡

返回结构

参数	示例值	说明/备注
tx_item_id	10007	结算数字货币ID
total_amount	"0.19000000"	开卡手续费
card_pool_id	10374	卡池 ID
client_order_no	TP1718204900991221760	自定义订单号
vendor_order_no	""	卡商交易 ID

[第二步].开卡结果查询

{
    "status": 200,
    "msg": "ok",
    "extend": {
        "date": "2025-04-21 18:55:35",
        "unique": "680624264232c620236627",
        "runtime": "1457.99 ms"
    },
    "data": {
        "vendor_result": 0,
        "is_bind": 1,
        "is_activate": 0,
        "card_pool_id": 10275,
        "audit_status": 2,
        "vendor_order_no": "xxxxxx",
        "open_card_remark\\": " "
    }
}

根据返回的 audit_status 判断开卡是否成功： 1 - 审核中，2 - 成功，3 - 失败

HTTP请求:

GET /openCardQuery

请求参数

参数	取值	必传	类型	备注
card_pool_id	10275	是	int	卡池 ID - (卡池唯一标识)
user_id	1000001	是	string	自定义用户ID
request_log_id	L1718217498410262528	是	string	调试日志标识
api_key	5G66cd41ab99651-EREDRERS	是	string	apiKey
timestamp	1746783841	是	int	请求时间戳秒
sign	9c062a8d614c84d0ea6debb...	是	string	签名

返回结构

参数	取值	备注
is_bind	1	已绑定：0 否、1 是
is_activate	0	激活：0 否、1 是
card_pool_id	10275	卡池 ID
audit_status	2	审核状态：0 待审核、1 审核中、2 审核通过、3 拒绝
vendor_order_no	xxxxxx	绑卡卡商订单 NO
open_card_remark	""	开卡备注
vendor_business_card_id	xxxx	卡商卡 ID ｜

[第三步].绑定手机号

{
  "status": 200,
  "msg": "ok",
  "extend": {
    "date": "2025-04-21 18:55:40",
    "unique": "6806242873fb2719207341",
    "runtime": "4030.54 ms"
  },
  "data": {
    "card_pool_id": 10275
  },
  "microtime": 1745232940505
}

手机号可以和 KYC 信息中的不一样

HTTP请求:

POST /bindCardPool

请求参数

参数	取值	必传	类型	备注
card_pool_id	10275	是	int	卡池 ID - (卡池唯一标识)
area	86	是	string	区号
mobile	15711111111	是	string	手机号 (排除开头0)
user_id	1000001	是	string	自定义用户ID
request_log_id	L1718217498410262528	是	string	调试日志标识
api_key	5G66cd41ab99651-EREDRERS	是	string	apiKey
timestamp	1746783841	是	int	请求时间戳秒
sign	9c062a8d614c84d0ea6debb...	是	string	签名

返回结构

参数	类型	备注
card_pool_id	int	卡池 ID - (卡池唯一标识)

[第四步].激活物理卡 (虚拟卡忽略)

{
  "status": 200,
  "msg": "ok",
  "extend": {
    "date": "2025-04-21 18:55:40",
    "unique": "6806242873fb2719207341",
    "runtime": "4030.54 ms"
  },
  "data": {
    "card_pool_id": 10275
  },
  "microtime": 1745232940505
}

激活成功后卡片就可以正常使用了

HTTP请求:

POST /physicalCard

请求参数

参数	取值	必传	类型	备注
card_pool_id	10275	是	int	卡池 ID - (卡池唯一标识)
request_log_id	L1718217498410262528	是	string	调试日志标识
api_key	5G66cd41ab99651-EREDRERS	是	string	apiKey
timestamp	1746783841	是	int	请求时间戳秒
sign	9c062a8d614c84d0ea6debb...	是	string	签名

返回结构

参数	类型	备注
card_pool_id	int	卡池 ID - (卡池唯一标识)

[第五步].更新卡的邮寄地址 (可选)

{
  "status": 200,
  "msg": "ok",
  "extend": {
    "date": "2025-04-21 18:55:40",
    "unique": "6806242873fb2719207341",
    "runtime": "4030.54 ms"
  },
  "data": {
    "country": "SG",
    "region": "Singapore",
    "city": "Singapore",
    "street": "79 Ayer Rajah Crescent",
    "house": "#04-08",
    "postal_code": "139955",
  },
  "microtime": 1745232940505
}

如果卡片邮寄的地址不是用户 KYC 中的地址，调用此接口更新，会优先使用这个接口设置的地址，多次调用后面的覆盖前面的

HTTP请求:

POST /v2/updateMailingAddress

请求参数

参数	取值	必传	类型	备注
card_pool_id	10275	是	int	卡池 ID - (卡池唯一标识)
country	SG	是	string	国家
region	Singapore	是	string	省/州
city	Singapore	是	string	城市
street	79 Ayer Rajah Crescent	是	string	街道
house	#04-08	是	string	门牌号
postal_code	139955	是	string	邮编
request_log_id	L1718217498410262528	是	string	调试日志标识
api_key	5G66cd41ab99651-EREDRERS	是	string	apiKey
timestamp	1746783841	是	int	请求时间戳秒
sign	9c062a8d614c84d0ea6debb...	是	string	签名

返回结构

参数	类型	备注
country	string	SG
region	string	Singapore
city	string	Singapore
street	string	79 Ayer Rajah Crescent
house	string	#04-08
postal_code	string	139955

[第六步].打印卡片 (可选)

{
  "status": 200,
  "msg": "ok",
  "extend": {
    "date": "2025-04-21 18:55:40",
    "unique": "6806242873fb2719207341",
    "runtime": "4030.54 ms"
  },
  "data": {
    "status": "REQUESTED_BY_USER"
  },
  "microtime": 1745232940505
}

激活成功后卡片就可以正常使用了

HTTP请求:

POST /v2/printCard

请求参数

参数	取值	必传	类型	备注
card_pool_id	10275	是	int	卡池 ID - (卡池唯一标识)
request_log_id	L1718217498410262528	是	string	调试日志标识
api_key	5G66cd41ab99651-EREDRERS	是	string	apiKey
timestamp	1746783841	是	int	请求时间戳秒
sign	9c062a8d614c84d0ea6debb...	是	string	签名

返回结构

参数	类型	备注
status	string	REQUESTED_BY_USER

通用接口

公共请求参数

参数	取值	必传	类型	备注
request_log_id	L1718217498410262528	是	string	调试日志标识
api_key	5G66cd41ab99651-EREDRERS	是	string	apiKey
timestamp	1746783841	是	int	请求时间戳秒
sign	9c062a8d614c84d0ea6debb...	是	string	签名

从卡池获取一张卡 (需要授权)

{
  "status": 200,
  "msg": "ok",
  "extend": {
    "date": "2025-05-09 17:44:02",
    "unique": "681dce61e9747624111092",
    "runtime": "774.91 ms"
  },
  "data": {
    "card_no": "",
    "card_pool_id": 10303,     
    "apply_status": 2,
    "dc_sensitive_id": 312,
    "third_channel_id": 101
  },
  "microtime": 1746783842731
}

HTTP请求:

POST /popCardPool

请求参数

参数	取值	必传	类型	备注
vendor_card_id	1000009	是	int	卡类型ID
user_id	1000001	是	string	自定义用户ID
user_card_id	1000001	是	string	自定义用户卡ID
client_order_no	TP1718204900991221760	是	string	自定义订单号
request_log_id	L1718217498410262528	是	string	调试日志标识
api_key	5G66cd41ab99651-EREDRERS	是	string	apiKey
timestamp	1746783841	是	int	请求时间戳秒
sign	9c062a8d614c84d0ea6debb...	是	string	签名

返回结构

参数	类型	备注
card_pool_id	int	卡池 ID - (卡池唯一标识)
apply_status	int	申请状态 1待审核 2 审核通过 3 审核失败 4初始化 5应用
dc_sensitive_id	int	敏感 ID
card_no	string	卡号(初始为空)
third_channel_id	int	商户渠道标识

获取敏感卡信息

{
    "status": 200,
    "msg": "ok",
    "extend": {
        "date": "2025-05-29 13:42:18",
        "unique": "6837f3b9974602103335005",
        "runtime": "1262.04 ms"
    },
    "data": "PfTTJpA4GMDDaEK1CAil1g6qpv9zu7ZN96l3661VlOCY/nDAL4Y/2mQiZviGP2XaznrsaXoachfPakGttFIf6XlqFsS4d3aUjXzeK756VOrPw9igq/lNMewcrr2BUN1c4JtQ9rVcv1LE/YUyc4lgVKCmYS1EBoenS51mt+zCgsiIsuu3gTaG0Z/C0JDAmi7S5JvhxtBZOIgAVggVDNLI1T5uWrpr9Wq3C8aCGtNPyVflXAgmvZ62KI60NwOQldpXEEbXJGFUth/3lH49qcrPppUbgh3QKuIskRKCcDHbv5HBeypHJNflHMVBDkVx/tv7uUjBH811CM/xzfRJm021PQ==",
    "microtime": 1748497338881
}

GET /encryptedCard

请求参数

参数	取值	必传	类型	备注
公共请求参数...		是		公共请求参数
card_pool_id	10374	是	int	自定义用户ID
public_key	"MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAj6q9ekUiOxcRYpAB+WgHTptUWOFNmr8vTbHIPdGIsoo3zN7kxrwVkdj7nxrMVFzAaqcEb4WCGl6kp9FbPF7cHFSODhP3wn1MbJRflIdvI4fgSQc8dnWnLkYIKCuzwDQ6/e/lJHvw4TQvLP5cuxZKgsDJTtci7DlKb7oGzaH03uHB+in7ZnzQSHk9jiiitvJhJcuFJTOAepzfK+Jy76cUQlXUNBFnWTLVmaSYQ1Mkxp7d+XFz/Xmzsn6Hcqz18ziaZo9R779cgWopQtdYVEPbuTaNlrq9oV2P9X4M/+OKMJ6/p8Mc5awEaUssmtqAl2kDbvbCltWMAX+cEWKI6Y1tVwIDAQAB"	是	string	公钥

返回结构

参数	示例值	说明/备注
data	""	加密后的卡敏感信息

卡敏感信息 public_key参数获取和解密

1. 验证工具

> openssl version
OpenSSL 1.0.2k-fips  26 Jan 2017

2. 生成私钥

> openssl genpkey -algorithm RSA -out private_key.pem -pkeyopt rsa_keygen_bits:2048

-----BEGIN PRIVATE KEY-----
MIIEvAIBADANBgkqhkiG9w0BAQEFAASCBKYwggSiAgEAAoIBAQCPqr16RSI7FxFi
kAH5aAdOm1RY4U2avy9Nscg90YiyijfM3uTGvBWR2PufGsxUXMBqpwRvhYIaXqSn
0Vs8XtwcVI4OE/fCfUxslF+Uh28jh+BJBzx2dacuRggoK7PANDr97+Uke/DhNC8s
/ly7FkqCwMlO1yLsOUpvugbNofTe4cH6KftmfNBIeT2OKKK28mEly4UlM4B6nN8r
4nLvpxRCVdQ0EWdZMtWZpJhDUyTGnt35cXP9ebOyfodyrPXzOJpmj1Hvv1yBailC
11hUQ9u5No2Wur2hXY/1fgz/44ownr+nwxzlrARpSyya2oCXaQNu9sKW1YwBf5wR
YojpjW1XAgMBAAECggEABpGDg4vrn7tTQ9KvtGvJgbzfo1ynA/81C3P9uA3UwSJJ
S32ZWhi5UmdoQa2jpUEZrwafJkt6rPf3cTtvf21wL39ngJnwcZzxmePtZsi2ZRp4
6lMsCYJ24p+4ZGsdwcOMOutKlQYcTOo/ierAlJvVS5sYLm7u8tE/vPygA6t28EWy
iQuoY4FrJAg18WKDQvvGFh+Z+kI1els+y5Na6Kx5evM1cd/a+M7dT4Noloa3pot1
A4BAKmKU7JtcTRAeWE4A+Me6cfes5GUuYPEuPV/+QeYAKP46htSq7q4hcst/KIcT
EtF9AHjgld7KT29T0jS+EUUHGR7ALUPK9vbA70YQSQKBgQDJXxocdWSQvSwBshqf
n3wVBk90kPglZ8sEhz5m/yDFcNOw7ma7p97zy9KyOpiAfA4Y6vAjBYPjJlrJBD/Q
dl6yiO8ddhxdFJDgSbzHgf1jifqzq/jc7nP9FZ/VS2OitGnSwF9oNvZWyKffKV7f
F6VicPX2bIsEdi+p3tm+8sGIwwKBgQC2pCiq7Lmy51ENW+qHVdtr1ETkTkVYk3So
MXU2vcx+/1uoNMgEdnmbXvlkAN8F7Jpu96uxhBI9Lf3J9S7MihByxwn1KcyPnA+k
jUMTfmJL79+3QiB/lF20Maeyg5OziXVLSxNo38LjPzw4fecBFjqXgfB52PehJU1d
A/AXgr5f3QKBgCFPewlEHguXT2VEagUHo8XykkgtBu9hGQM5wAfXojsm682z0giu
v0HC8KqM6NcwLkDO9ERG0EdN++yOqGO6gPW1kyBjflOjaEfBytmR1jGWDIOWKgeZ
5lPyNMtaujOa9npnWiDqHpvCe4p91HTA+5mqJ/XIhMKLLl1CQPDGRV9zAoGAMZM7
irG48ivBn2usrFGMvqcekA4C2rkjuCe8lkBMishLm8u/4x45ggf0j8WAw/3mKWrG
yud7f+nE8pW/vztWnaETPd27rduBj3vckiUDD3Or+PVVFuwxxyCXUWhPpjMQiIB3
Y0chgkd+1CKwmmXrP4bAvII9LRuP9UiFWgxeGm0CgYBwb42eQOgbd9D6oxIopfUw
PjshT4NaOh9KOig01Ujf5k7lTE5Rk951+QJoScKgzBKWiAl9Eg2ZzY1uqav0opl7
sR2+sNhSBtOYzfD+NMJQ2BrjKbobMJNA9h35UjoJw/Jw8Hb6ATfe7KLEXo6ijllX
1Xij5j4/P0p+bG7/l/2Q3w==
-----END PRIVATE KEY-----

3. 从私钥中提取公钥

> openssl pkey -in private_key.pem -pubout -out public_key.pem

-----BEGIN PUBLIC KEY-----
MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAj6q9ekUiOxcRYpAB+WgH
TptUWOFNmr8vTbHIPdGIsoo3zN7kxrwVkdj7nxrMVFzAaqcEb4WCGl6kp9FbPF7c
HFSODhP3wn1MbJRflIdvI4fgSQc8dnWnLkYIKCuzwDQ6/e/lJHvw4TQvLP5cuxZK
gsDJTtci7DlKb7oGzaH03uHB+in7ZnzQSHk9jiiitvJhJcuFJTOAepzfK+Jy76cU
QlXUNBFnWTLVmaSYQ1Mkxp7d+XFz/Xmzsn6Hcqz18ziaZo9R779cgWopQtdYVEPb
uTaNlrq9oV2P9X4M/+OKMJ6/p8Mc5awEaUssmtqAl2kDbvbCltWMAX+cEWKI6Y1t
VwIDAQAB
-----END PUBLIC KEY-----

4. 去掉空格, 提取public_key 公钥

MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAj6q9ekUiOxcRYpAB+WgHTptUWOFNmr8vTbHIPdGIsoo3zN7kxrwVkdj7nxrMVFzAaqcEb4WCGl6kp9FbPF7cHFSODhP3wn1MbJRflIdvI4fgSQc8dnWnLkYIKCuzwDQ6/e/lJHvw4TQvLP5cuxZKgsDJTtci7DlKb7oGzaH03uHB+in7ZnzQSHk9jiiitvJhJcuFJTOAepzfK+Jy76cUQlXUNBFnWTLVmaSYQ1Mkxp7d+XFz/Xmzsn6Hcqz18ziaZo9R779cgWopQtdYVEPbuTaNlrq9oV2P9X4M/+OKMJ6/p8Mc5awEaUssmtqAl2kDbvbCltWMAX+cEWKI6Y1tVwIDAQAB

5. 解密响应

 > echo "PfTTJpA4GMDDaEK1CAil1g6qpv9zu7ZN96l3661VlOCY/nDAL4Y/2mQiZviGP2XaznrsaXoachfPakGttFIf6XlqFsS4d3aUjXzeK756VOrPw9igq/lNMewcrr2BUN1c4JtQ9rVcv1LE/YUyc4lgVKCmYS1EBoenS51mt+zCgsiIsuu3gTaG0Z/C0JDAmi7S5JvhxtBZOIgAVggVDNLI1T5uWrpr9Wq3C8aCGtNPyVflXAgmvZ62KI60NwOQldpXEEbXJGFUth/3lH49qcrPppUbgh3QKuIskRKCcDHbv5HBeypHJNflHMVBDkVx/tv7uUjBH811CM/xzfRJm021PQ==" | base64 -d > decoded_message.bin

6. 解密消息

使用 openssl 解密消息并将内容存储在名为 decrypted_message.txt 的文件中。

> openssl pkeyutl -decrypt \
  -inkey private_key.pem \
  -pkeyopt rsa_padding_mode:oaep \
  -pkeyopt rsa_oaep_md:sha1 \
  -in decoded_message.bin \
  -out decrypted_message.txt

解密的消息将包含如下所示的 JSON 对象：
{
    "cvv": "550",
    "expire": "04/28",
    "card_no": "3977556872941872265"
}

锁卡

{
    "status": 200,
    "msg": "ok",
    "extend": {
        "date": "2025-04-22 09:32:43",
        "unique": "6806f1ba93824365093491",
        "runtime": "1169.78 ms"
    },
    "data": {
        "third_channel_id": 101,
        "card_pool_id": 10275,
        "lock_status": 0,
        "vendor_customer_no": "01JS9RGZ724CFJZTM1W6P5R5J6",
        "vendor_business_card_id": "01JS1GJ1MG8NG5KW5HXZ5RWYR9"
    }
}

HTTP请求:

POST /lockCard

请求参数

参数	取值	必传	类型	备注
card_pool_id	10275	是	int	卡池 ID - (卡池唯一标识)
request_log_id	L1718217498410262528	是	string	调试日志标识
api_key	5G66cd41ab99651-EREDRERS	是	string	apiKey
timestamp	1746783841	是	int	请求时间戳秒
sign	9c062a8d614c84d0ea6debb...	是	string	签名

返回结构

参数	取值	备注
third_channel_id	101	商户渠道标识
card_pool_id	10275	卡池 ID - (卡池唯一标识)
lock_status	0	锁定状态 1锁定 0未锁定
vendor_customer_no	01JS9RGZ724CFJZTM1W6P5R5J6	供应商客户号
vendor_business_card_id	01JS1GJ1MG8NG5KW5HXZ5RWYR9	供应商业务卡 ID

解卡

{
    "status": 200,
    "msg": "ok",
    "extend": {
        "date": "2025-04-22 09:32:43",
        "unique": "6806f1ba93824365093491",
        "runtime": "1169.78 ms"
    },
    "data": {
        "third_channel_id": 101,
        "card_pool_id": 10275,
        "lock_status": 0,
        "vendor_customer_no": "01JS9RGZ724CFJZTM1W6P5R5J6",
        "vendor_business_card_id": "01JS1GJ1MG8NG5KW5HXZ5RWYR9"
    }
}

HTTP请求:

POST /unlockCard

请求参数

参数	取值	必传	类型	备注
card_pool_id	10275	是	int	卡池 ID - (卡池唯一标识)
request_log_id	L1718217498410262528	是	string	调试日志标识
api_key	5G66cd41ab99651-EREDRERS	是	string	apiKey
timestamp	1746783841	是	int	请求时间戳秒
sign	9c062a8d614c84d0ea6debb...	是	string	签名

返回结构

参数	取值	备注
third_channel_id	101	商户渠道标识
card_pool_id	10275	卡池 ID - (卡池唯一标识)
lock_status	0	锁定状态 1锁定 0未锁定
vendor_customer_no	01JS9RGZ724CFJZTM1W6P5R5J6	供应商客户号
vendor_business_card_id	01JS1GJ1MG8NG5KW5HXZ5RWYR9	供应商业务卡 ID

储蓄卡充值 (共享卡不支持充值)

{
  "status": 200,
  "msg": "ok",
  "extend": {
    "date": "2025-05-12 11:34:49",
    "unique": "68216c59ac1ac1325023547",
    "runtime": "32.66 ms"
  },
  "data": {
    "recharge_status": 3,
    "vendor_order_no": "",
    "client_order_no": "RC1750033464124985344",
    "error_msg": ""
  },
  "microtime": 1747020889737
}

HTTP请求:

POST /recharge

请求参数

参数	取值	必传	类型	备注
card_pool_id	10275	是	int	卡池 ID - (卡池唯一标识)
client_order_no	RD1234	是	string	商户自定义充值订单NO (防止重复充值请保持唯一)
channel_item_number	100.00	是	string	充值金额 (平台默认仅支持USDT)
request_log_id	L1718217498410262528	是	string	调试日志标识
api_key	5G66cd41ab99651-EREDRERS	是	string	apiKey
timestamp	1746783841	是	int	请求时间戳秒
sign	9c062a8d614c84d0ea6debb...	是	string	签名

返回结构

参数	取值	备注
recharge_status	1	充值状态 1 充值中 2 充值成功 3充值失败
vendor_order_no	xxxx	卡商充值订单号
client_order_no	xxxx	商户自定义充值订单NO (防止重复充值请保持唯一)
error_msg	共享卡不支持充值	异常响应描述

储蓄卡充值记录查询 (确认充值结果)

{
  "status": 200,
  "msg": "ok",
  "extend": {
    "date": "2025-05-12 11:39:19",
    "unique": "68216d66f33de1009014995",
    "runtime": "177.14 ms"
  },
  "data": {
    "error_msg": "success",
    "recharge_status": 1,
    "vendor_order_no": "",
    "channel_item_number": "15.81000000",
    "recharge_finish_time": 0,
    "vendor_currency_number": "15.49000000"
  },
  "microtime": 1747021159173
}

HTTP请求:

GET /rechargeQuery

请求参数

参数	取值	必传	类型	备注
client_order_no	RD1234	是	string	商户自定义充值订单NO (防止重复充值请保持唯一)
request_log_id	L1718217498410262528	是	string	调试日志标识
api_key	5G66cd41ab99651-EREDRERS	是	string	apiKey
timestamp	1746783841	是	int	请求时间戳秒
sign	9c062a8d614c84d0ea6debb...	是	string	签名

返回结构

参数	取值	备注
recharge_status	1	充值状态 1 充值中 2 充值成功 3充值失败
vendor_order_no	xxxx	卡商充值订单号
channel_item_number	xxxx	三方消耗金额(USDT)
recharge_finish_time	0	充值完成时间
vendor_currency_number	100	卡商信用卡到账数量 (参考卡法币类型 USD/HKD/AED 等等)
error_msg	success	异常响应描述

卡绑定手机号

{
  "status": 200,
  "msg": "ok",
  "extend": {
    "date": "2025-05-13 15:49:07",
    "unique": "6822f9730dffa1219074989",
    "runtime": "669.81 ms"
  },
  "data": {
    "card_pool_id": 10060,
    "object": {
      "userId": "1896401992281100288",
      "cardId": "VC2761374937251282948",
      "status": "ACTIVE"
    }
  },
  "microtime": 1747122547727
}

HTTP请求:

POST /bindPhone

请求参数

参数	取值	必传	类型	备注
card_pool_id	10060	是	int	卡池 ID - (卡池唯一标识)
area	86	是	string	区号
mobile	15711111111	是	string	手机号 (排除开头0)
request_log_id	L1718217498410262528	是	string	调试日志标识
api_key	5G66cd41ab99651-EREDRERS	是	string	apiKey
timestamp	1746783841	是	int	请求时间戳秒
sign	9c062a8d614c84d0ea6debb...	是	string	签名

返回结构

参数	取值	备注
card_pool_id	10060	卡池 ID - (卡池唯一标识)

获取设置 Pin 码的 URL(修改提款码使用)

{
  "status": 200,
  "msg": "ok",
  "extend": {
    "date": "2025-05-14 15:37:01",
    "unique": "6824481c05a9f424823310",
    "runtime": "1847.31 ms"
  },
  "data": {
    "iframe_url": ""
  },
  "microtime": 1747208221874
}

HTTP请求:

POST /getIframePinUrl

请求参数

参数	取值	必传	类型	备注
card_pool_id	10060	是	int	卡池 ID - (卡池唯一标识)
request_log_id	L1718217498410262528	是	string	调试日志标识
api_key	5G66cd41ab99651-EREDRERS	是	string	apiKey
timestamp	1746783841	是	int	请求时间戳秒
sign	9c062a8d614c84d0ea6debb...	是	string	签名

返回结构

参数	取值	备注
iframe_url	https://xxxxx	设置 Pin 码的 URL

用户卡信息 / 卡余额

{
  "status": 200,
  "msg": "ok",
  "extend": {
    "date": "2025-05-14 15:54:10",
    "unique": "68244c220e38d1704722825",
    "runtime": "289.62 ms"
  },
  "data": {
    "area": "81",
    "mobile": "8045673214",
    "last_name": "",
    "first_name": "",
    "user_name": "DA ZHENG",
    "issue_vendor": "",
    "max_spend_amount_single": 0,
    "balance": "277.73000000",
    "issue_time": 1737609120,
    "kyc_status": 3,
    "card_status": 3,
    "apply_status": 2,
    "audit_status": 2,
    "open_status": 1,
    "real_open_status": 1
  },
  "microtime": 1747209250348
}

HTTP请求:

GET /getCardRights

请求参数

参数	取值	必传	类型	备注
user_id	1000001	是	string	自定义用户ID
card_pool_id	10060	是	int	卡池 ID - (卡池唯一标识)
request_log_id	L1718217498410262528	是	string	调试日志标识
api_key	5G66cd41ab99651-EREDRERS	是	string	apiKey
timestamp	1746783841	是	int	请求时间戳秒
sign	9c062a8d614c84d0ea6debb...	是	string	签名

返回结构

参数	示例值	说明/备注
area	81	手机区号（如日本为81）
mobile	8045673214	手机号
last_name	（空）	用户姓
first_name	（空）	用户名
user_name	DA ZHENG	用户全名
issue_vendor	（空）	发卡机构
max_spend_amount_single	0	单笔最大消费金额
balance	277.73000000	卡余额
issue_time	1737609120	发卡时间（Unix时间戳）
card_status	3	卡片状态 1 开卡进行中 2 此状态可以调用接口激活 3 卡已激活 4 锁定 5 暂停 6 撤销
open_status	1	0 等待审核 1 审核通过 2 审核拒绝

交易记录列表 (卡账单)

{
  "status": 200,
  "msg": "ok",
  "extend": {
    "date": "2025-04-23 20:21:58",
    "unique": "6808db667df5b1567176189",
    "runtime": "20.8 ms"
  },
  "data": {
    "list": [
      {
        "bill_id": 6316,
        "vendor_id": 6667,
        "vendor_card_id": 1000009,
        "third_channel_id": 101,
        "user_id": 10100009895,
        "card_pool_id": 10275,
        "vendor_business_card_id": "01JS1GJ1MG8NG5KW5HXZ5RWYR9",
        "vendor_order_no": "316885847018598",
        "client_order_no": "76b73da2-9166-45fe-9c60-8dabfd3611cb",
        "bill_type": 1,
        "vendor_bill_type": "1",
        "currency_amount": "1234.00000000",
        "currency_id": 5,
        "tx_item_id": 10007,
        "tx_amount": "8.19000000",
        "fee": "0.00000000",
        "usdt_amount": "8.19000000",
        "status": 1,
        "direction": 1,
        "trade_merchant": "TEST CN CN",
        "trade_time": 1745333659,
        "trade_begin_time": 1745333556,
        "card_balance": "0.00000000"
      }
    ]
  },
  "pageInfo": { 
    "pageCurrent": 1,
    "pageCount": 200,
    "pageSize": 100,
    "pageTotal": 2
  }
}

HTTP请求:

GET /channelBillList

请求参数

参数	取值	必传	类型	备注
card_pool_id	10275	否	int	卡池 ID - (卡池唯一标识)
bill_id	6316	否	int	账单唯一ID (>= bill_id 的记录升序）
vendor_order_no	316885847018598-AD12312312	否	string	卡商订单号 (`-`最左like) 筛选
vendor_bill_type	1,2,3	否	string	多选逗号连接，交易类型:1/授权消费,3/充值,4/取款,5/退款, 8.交易预冻结 9 结算调整
bill_type	1,2	否	string	多选逗号连接，账单类型:1 消费 2 充值 3 取款 4 退款
start_time	1754823990	否	string	开始时间时间戳（秒）与结束必须同时传
end_time	1755428801	否	string	结束时间时间戳（秒）与开始必须同时传
page	1	是	int	翻页当前页码
page_size	100	是	int	每页记录数,最大200条
request_log_id	L1718217498410262528	是	string	调试日志标识
api_key	5G66cd41ab99651-EREDRERS	是	string	apiKey
timestamp	1746783841	是	int	请求时间戳秒
sign	9c062a8d614c84d0ea6debb...	是	string	签名

返回结构

参数	取值	备注
bill_id	6316	账单唯一ID
vendor_id	6667	卡商ID
vendor_card_id	1000009	卡商类型ID
third_channel_id	101	商户渠道标识
user_id	10100009895	自定义用户ID
card_pool_id	10275	卡池 ID - (卡池唯一标识)
vendor_business_card_id	01JS1GJ1MG8NG5KW5HXZ5RWYR9	供应商业务卡 ID
vendor_order_no	316885847018598	卡商订单号
bill_type	1	账单类型:1 消费 2 充值 3 取款 4 退款
vendor_bill_type	"1"	交易类型:1/授权消费,3/充值,4/取款,5/退款,8.交易预冻结 9 结算调整
currency_amount	"1234.00000000"	消费法币金额
currency_id	5	消费法币ID
tx_item_id	10007	结算数字货币ID
tx_amount	"8.19000000"	结算数量
fee	"0.00000000"	手续费
usdt_amount	"8.19000000"	USDT金额
status	1	状态:1/成功,2/取消,3/消费进行中(仅充值卡使用) 4/失败 5/退款进行中（仅共享卡使用）
direction	1	交易方向 1 付款 2 收款（注意⚠️该接口字段 1 减钱 2 加钱）
trade_merchant	"TEST CN CN"	商户名称
trade_time	1745333659	交易时间
trade_begin_time	1745333556	交易开始时间

账单类型 bill_type / 交易类型 vendor_bill_type (具体场景)

1. 消费

1 授权消费: 常规消费
8 交易预冻结: 订酒店押金场景
9 结算调整: 追扣受 Visa 结算时间影响

2. 充值

3 充值: 充值卡

3. 取款

4 取款: 充值卡维护的取款类型

4. 退款

5 退款: 常规退款
9 结算调整: 受 Visa 次日结算汇率影响，亦有次日退款影响

交易记录详情

{
    "status": 200,
    "msg": "ok",
    "extend": {
        "date": "2025-04-23 20:21:58",
        "unique": "6808db667df5b1567176189",
        "runtime": "20.8 ms"
    },
    "data": {
        "bill_id": 6316,
        "vendor_id": 6667,
        "vendor_card_id": 1000009,
        "third_channel_id": 101,
        "user_id": 10100009895,
        "card_pool_id": 10275,
        "vendor_business_card_id": "01JS1GJ1MG8NG5KW5HXZ5RWYR9",
        "vendor_order_no": "316885847018598",
        "client_order_no": "76b73da2-9166-45fe-9c60-8dabfd3611cb",
        "bill_type": 1,
        "vendor_bill_type": "1",
        "currency_amount": "1234.00000000",
        "currency_id": 5,
        "tx_item_id": 10007,
        "tx_amount": "8.19000000",
        "fee": "0.00000000",
        "usdt_amount": "8.19000000",
        "status": 1,
        "direction": 1,
        "trade_merchant": "TEST CN CN",
        "trade_time": 1745333659,
        "trade_begin_time": 1745333556,
        "card_balance": "0.00000000"
    }
}

HTTP请求:

GET /userBillInfo

请求参数

参数	取值	必传	类型	备注
bill_id	6316	是	int	账单唯一ID
request_log_id	L1718217498410262528	是	string	调试日志标识
api_key	5G66cd41ab99651-EREDRERS	是	string	apiKey
timestamp	1746783841	是	int	请求时间戳秒
sign	9c062a8d614c84d0ea6debb...	是	string	签名

返回结构

参数	取值	备注
bill_id	6316	账单唯一ID
vendor_id	6667	卡商ID
vendor_card_id	1000009	卡商类型ID
third_channel_id	101	商户渠道标识
user_id	10100009895	自定义用户ID
card_pool_id	10275	卡池 ID - (卡池唯一标识)
vendor_business_card_id	01JS1GJ1MG8NG5KW5HXZ5RWYR9	供应商业务卡 ID
vendor_order_no	316885847018598	卡商订单号
bill_type	1	账单类型:1 消费 2 充值 3 取款 4 退款
vendor_bill_type	"1"	交易类型:1/授权消费,3/充值,4/取款,5/退款, 8.交易预冻结 9 结算调整
currency_amount	"1234.00000000"	消费法币金额
currency_id	5	消费法币ID
tx_item_id	10007	结算数字货币ID
tx_amount	"8.19000000"	结算数量
fee	"0.00000000"	手续费
usdt_amount	"8.19000000"	USDT金额
status	1	状态:1/成功,2/取消,3/处理中 4/失败
direction	1	方向交易方向 1 付款 2 收款（注意⚠️该接口字段 1 减钱 2 加钱）
trade_merchant	"TEST CN CN"	商户名称
trade_time	1745333659	交易时间
trade_begin_time	1745333556	交易开始时间

商户相关接口

商户资金余额

{
  "status": 200,
  "msg": "ok",
  "extend": {
    "date": "2025-04-23 20:21:58",
    "unique": "6808db667df5b1567176189",
    "runtime": "20.8 ms"
  },
  "data": {
    "balance":"1000",
    "over_balance":"900",
    "lock_balance":"100",
  }
}

HTTP请求:

GET /asset

请求参数

参数	取值	必传	类型	备注
vendor_card_id	1000009	是	string	卡商类型ID
request_log_id	L1718217498410262528	是	string	调试日志标识
api_key	5G66cd41ab99651-EREDRERS	是	string	apiKey
timestamp	1746783841	是	int	请求时间戳秒
sign	9c062a8d614c84d0ea6debb...	是	string	签名

返回结构

参数	取值	备注
balance	1000.00	总余额
over_balance	900.00	可用余额
lock_balance	100.00	冻结余额

商户已开通卡列表

{
  "status": 200,
  "msg": "ok",
  "extend": {
    "date": "2025-05-14 14:50:02",
    "unique": "68243d1aa2208705348335",
    "runtime": "59.98 ms"
  },
  "data": [
    {
      "vendor_card_id": 1000009,
      "vendor_id": 6667,
      "name": "Stx 共享卡 U",
      "status": 1,
      "open_card_status": 0,
      "recharge_status": 0,
      "release_type": 1,
      "balance_type": 2,
      "issue_vendor": "Visa",
      "currency_id": 1,
      "item_id": 10007,
      "open_card_fee": "0.00000000000000000000",
      "recharge_fee_rate": "0.00000000000000000000",
      "recharge_fee": "0.00000000000000000000",
      "first_recharge_amount": "0.00000000",
      "min_recharge_amount_single": "0.00000000",
      "max_recharge_amount_single": "0.00000000",
      "spend_fee": "0.00000000",
      "shipment_fee": "0.00000000",
      "max_spend_amount_single": "50000.00000000",
      "is_user_kyc": 0,
      "is_bind_mobile": 0,
      "is_bind_email": 0,
      "card_pool_threshold": 0,
      "spend_fee_rate": "0.00000000",
      "create_time": 0,
      "update_time": 0,
      "created_at": "2025-04-15 14:40:13",
      "updated_at": "2025-05-09 18:55:15"
    }
  ],
  "microtime": 1747205402724
}

HTTP请求:

GET /channelVendorCardConfList

请求参数

参数	取值	必传	类型	备注
request_log_id	L1718217498410262528	是	string	调试日志标识
api_key	5G66cd41ab99651-EREDRERS	是	string	apiKey
timestamp	1746783841	是	int	请求时间戳秒
sign	9c062a8d614c84d0ea6debb...	是	string	签名

返回结构

参数	取值	备注
vendor_card_id	1000009 / 1000011	卡商卡ID
vendor_id	6667 / 6668	卡商ID
name	Stx 共享卡 U	卡名称
status	1	状态（1=启用）非1关闭
open_card_status	0	开卡状态:0 关闭,1 开
recharge_status	0	充值状态:0 关闭,1 开
release_type	1	卡介质类型: 1.虚拟卡 2.实体卡
balance_type	2	余额类型 1 充值卡 2 共享卡 3充值+授信
issue_vendor	Visa	发卡机构
currency_id	1	支持法币ID
item_id	10007	结算数字货币ID
open_card_fee	0.00000000000000000000	开卡手续费
recharge_fee_rate	0.00000000000000000000	充值手续费
recharge_fee	0.00000000000000000000	充值单笔手续费 (卡商)
first_recharge_amount	0.00000000	首次充值金额
min_recharge_amount_single	0.00000000	充值单笔最小限额
max_recharge_amount_single	0.00000000	充值单笔最大限额
spend_fee	0.00000000	消费手续费 (卡商参考)
shipment_fee	0.00000000	邮寄手续费 (卡商参考)
max_spend_amount_single	50000.00000000 / 0.00000000	单笔消费最大限额 (卡商参考)
is_user_kyc	0	是否需要 KYC：0 - 不需要、1 - 需要
is_bind_mobile	0	是否需要手机号：0 - 否，1 - 是
is_bind_email	0	是否需要邮箱：0 - 否，1 - 是
card_pool_threshold	0	卡池最少数量阈值
spend_fee_rate	0.00000000	消费费率

商户充提币记录

{
  "status": 200,
  "msg": "ok",
  "extend": {
    "date": "2025-08-22 11:53:07",
    "unique": "68a7e9a31672c2016247719",
    "runtime": "43.87 ms"
  },
  "data": {
    "list": [
      {
        "type": 2,
        "item_id": 10007,
        "txid": "",
        "uce_id": 2856,
        "chain_tag": "erc20",
        "num": "2",
        "network_fee": "8",
        "status": "faild",
        "create_time": 1603588074
      }
    ],
    "pageInfo": {
      "pageCurrent": 1,
      "pageCount": 0,
      "pageSize": 1,
      "pageTotal": 0
    }
  },
  "microtime": 1755834787135
}

HTTP请求:

GET /depositWithdrawalRecords

请求参数

参数	取值	必传	类型	备注
vendor_card_id	1000011	是	int	卡商类型ID
start_time	1754823990	否	int	开始时间时间戳（秒）与结束必须同时传
end_time	1755428801	否	int	结束时间时间戳（秒）与开始必须同时传
page	1	是	int	翻页当前页码
page_size	100	是	int	每页记录数,最大200条
request_log_id	L1718217498410262528	是	string	调试日志标识
api_key	5G66cd41ab99651-EREDRERS	是	string	apiKey
timestamp	1746783841	是	int	请求时间戳秒
sign	9c062a8d614c84d0ea6debb...	是	string	签名

返回结构

参数	取值	备注
uce_id	1	流水ID
type	1	型1冲2提
item_id	10007	币种ID
txid	xxxx	交易ID
chain_tag	erc20	chain
num	100	充提数量
status	1	状态 waiting打包中 pending发送中 confirming确认中 cantrade可交易 success已完成 faild失败
network_fee	1	手续费数量
create_time	1754823990	创建时间戳

商户金融卡相关资金流水

{
  "status": 200,
  "msg": "ok",
  "extend": {
    "date": "2025-04-23 20:21:58",
    "unique": "6808db667df5b1567176189",
    "runtime": "20.8 ms"
  },
  "data": {
    "list": [
      {
        "id": 389,
        "vendor_card_id": 1000009,
        "card_pool_id": 10274,
        "client_order_no": "AH1508526070575149056",
        "vendor_order_no": "065694769779883",
        "op_type": 6,
        "amount": "3",
        "item_id": 10007,
        "create_time": 1745227738,
        "direction": -1
      }
    ],
    "pageInfo": {
      "pageCurrent": 1,
      "pageCount": 99,
      "pageSize": 1,
      "pageTotal": 99
    }
  }
}

HTTP请求:

GET /assetFlowList

请求参数

参数	取值	必传	类型	备注
id	100	否	int	账单ID (>= id 的记录升序
card_pool_id	100009	否	int	卡池唯一ID
client_order_no	e913c476-07fe-437c-925a-ea1b0e9701b5	否	string	三方自定义订单号
op_type	1,2,3,4	否	string	操作类型英文逗号连接多类型查询
start_time	1754823990	否	string	开始时间时间戳（秒）与结束必须同时传
end_time	1755428801	否	string	结束时间时间戳（秒）与开始必须同时传
client_order_no	e913c476-07fe-437c-925a-ea1b0e9701b5	否	string	三方自定义订单号
page	1	是	int	翻页当前页码
page_size	100	是	int	每页记录数,最大200条
request_log_id	L1718217498410262528	是	string	调试日志标识
api_key	5G66cd41ab99651-EREDRERS	是	string	apiKey
timestamp	1746783841	是	int	请求时间戳秒
sign	9c062a8d614c84d0ea6debb...	是	string	签名

返回结构

参数	取值	备注
id	1	唯一ID
card_pool_id	1000009	卡池唯一ID
vendor_card_id	1000009	卡商类型ID
vendor_order_no	"316885847018598"	卡商订单号
client_order_no	"76b73da2916645fe9c608dabfd3611cb"	渠道订单号
op_type	1	操作类型:1.开卡费 2.充值 3.开卡押金 4.充值手续费 5.快递费 6.共享卡消费 7.共享卡退款 8.消费手续费
amount	"1.00"	金额
item_id	10007	结算数字货币ID
direction	1	资金方向 1 收入 -1支出
create_time	1745333556	创建时间

开卡申请记录

{
  "status": 200,
  "msg": "ok",
  "extend": {
    "date": "2025-04-23 20:21:58",
    "unique": "6808db667df5b1567176189",
    "runtime": "20.8 ms"
  },
  "data": {
    "list": [
      {
        "card_pool_id": 10000,
        "status": 2,
        "vendor_card_id": 1,
        "vendor_id": 11,
        "client_order_no": "TP870154370764185600",
        "apply_time": 1740475982,
        "finish_time": 1740476982
      }
    ],
    "pageInfo": {
      "pageCurrent": 1,
      "pageCount": 1,
      "pageSize": 1,
      "pageTotal": 1
    }
  }
}

HTTP请求:

GET /applyRecord

请求参数

参数	取值	必传	类型	备注
card_pool_id	100009	否	int	卡池唯一ID
apply_start_time	1754823990	否	int	申请开始时间时间戳（秒）与申请结束必须同时传
apply_end_time	1754823990	否	int	申请结束时间时间戳（秒）与申请开始必须同时传
finish_start_time	1754823990	否	int	完成开始时间时间戳（秒）与完成结束必须同时传
finish_end_time	1755428801	否	int	完成结束时间时间戳（秒）与完成开始必须同时传
page	1	是	int	翻页当前页码
page_size	100	是	int	每页记录数,最大200条
request_log_id	L1718217498410262528	是	string	调试日志标识
api_key	5G66cd41ab99651-EREDRERS	是	string	apiKey
timestamp	1746783841	是	int	请求时间戳秒
sign	9c062a8d614c84d0ea6debb...	是	string	签名

返回结构

参数	取值	备注
card_pool_id	10009	卡池ID
vendor_card_id	7777	卡商类型ID
vendor_id	7777	卡商ID
client_order_no	TT879798779897	三方订单号
status	1	申请状态 0初始 1申请中 2通过 3拒绝
apply_time	1754823990	申请时间戳
finish_time	1755428801	完成时间戳，初始状态和申请中状态为0

卡的 Token 列表

{
  "status": 200,
  "msg": "ok",
  "extend": {
    "date": "2026-07-08 12:00:00",
    "unique": "686de84000000000000000",
    "runtime": "120.35 ms"
  },
  "data": {
    "page": 1,
    "total_data": 1,
    "total_pages": 1,
    "data": [
      {
        "opaque_id": "01J5SMMR191M99VB5HC8BPGXZ3",
        "token_requestor_id": "40010030273",
        "token_reference_id": "DNITHE302419023843019303",
        "pan_reference_id": "V-3024151221021929591158",
        "pan_source": "KEY_ENTERED",
        "status": "INACTIVE",
        "client_wallet_account_id": "",
        "token_requestor": "APPLE_PAY",
        "token_type": "SECURE_ELEMENT",
        "truncated_token_account_number": "4111********1234"
      }
    ],
    "card_pool_id": 10374
  },
  "microtime": 1783492800000
}

HTTP请求:

POST /v2/getCardTokenList

请求参数

参数	取值	必传	类型	备注
公共请求参数...		是		公共请求参数
card_pool_id	10374	是	int	卡池 ID - (卡池唯一标识)
page_num	1	否	int	页码，默认 1
page_size	100	否	int	每页记录数，默认 100

返回结构

参数	类型	备注
card_pool_id	int	卡池 ID
page	int	当前页码
total_data	int	总记录数
total_pages	int	总页数
data	array	Token 列表

data[] 字段

参数	类型	备注
opaque_id	string	Token Opaque ID，更新状态时使用
token_requestor_id	string	Token 请求方 ID
token_reference_id	string	Token Reference ID
pan_reference_id	string	PAN Reference ID
pan_source	string	PAN 来源
status	string	Token 状态：INACTIVE、ACTIVE、SUSPENDED、DEACTIVATED
client_wallet_account_id	string	钱包账户 ID
token_requestor	string	Token 请求方，如 APPLE_PAY
token_type	string	Token 类型，如 SECURE_ELEMENT
truncated_token_account_number	string	脱敏 Token 卡号

更新卡的 Token 状态

{
  "status": 200,
  "msg": "ok",
  "extend": {
    "date": "2026-07-08 12:00:00",
    "unique": "686de84000000000000001",
    "runtime": "98.16 ms"
  },
  "data": {
    "card_pool_id": 10374,
    "status": "SUSPENDED",
    "reason": "user request"
  },
  "microtime": 1783492800001
}

HTTP请求:

POST /v2/updateCardTokenStatus

请求参数

参数	取值	必传	类型	备注
公共请求参数...		是		公共请求参数
card_pool_id	10374	是	int	卡池 ID - (卡池唯一标识)
token_opaque_id	01J5SMMR191M99VB5HC8BPGXZ3	是	string	Token Opaque ID
status	SUSPENDED	是	string	Token 状态：ACTIVE、SUSPENDED、DEACTIVATED
reason	user request	是	string	更新原因

返回结构

参数	类型	备注
card_pool_id	int	卡池 ID
status	string	更新后的状态
reason	string	更新原因

呼叫中心激活

{
  "status": 200,
  "msg": "ok",
  "extend": {
    "date": "2026-07-08 12:00:00",
    "unique": "686de84000000000000002",
    "runtime": "136.77 ms"
  },
  "data": {
    "card_pool_id": 10374,
    "card_token": {
      "opaque_id": "01J5SMMR191M99VB5HC8BPGXZ3",
      "status": "INACTIVE"
    }
  },
  "microtime": 1783492800002
}

该接口用于钱包加卡过程中的呼叫中心验证激活，不要用 updateCardTokenStatus(ACTIVE) 替代。

HTTP请求:

POST /v2/callCenterActivation

请求参数

参数	取值	必传	类型	备注
公共请求参数...		是		公共请求参数
card_pool_id	10374	是	int	卡池 ID - (卡池唯一标识)
token_type	1	是	int	Token 类型，见下方枚举

token_type 枚举

值	Token 请求方
1	APPLE_PAY
2	GOOGLE_PAY_HCE
3	GOOGLE_PAY_SE
4	SAMSUNG_PAY
5	FIDESMO_PAY
6	TAPPY
7	SWATCH_PAY
8	GARMIN

返回结构

参数	类型	备注
card_pool_id	int	卡池 ID
card_token	object	卡商返回的 Token 信息
card_token.opaque_id	string	Token Opaque ID
card_token.status	string	Token 状态

获取绑定 Apple Pay 的参数

{
  "status": 200,
  "msg": "ok",
  "extend": {
    "date": "2026-07-08 12:00:00",
    "unique": "686de84000000000000003",
    "runtime": "142.41 ms"
  },
  "data": {
    "activation_data": "eyJ2ZXJzaW9uIjoiRUNfdjEiLCJkYXRhIjoiLi4uIn0=",
    "encrypted_pass_data": "K3YvQmR0R0FvT2NQYlZlLi4u",
    "ephemeral_public_key": "MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAE..."
  },
  "microtime": 1783492800003
}

HTTP请求:

POST /v2/applePayProvisioning

请求参数

参数	取值	必传	类型	备注
公共请求参数...		是		公共请求参数
card_pool_id	10374	是	int	卡池 ID - (卡池唯一标识)
apple_public_certificates	MIIC...	是	string	Apple Public Certificates，多个证书用英文逗号分隔
nonce	qU0x...	是	string	Apple Pay nonce
nonce_signature	MEUCIQ...	是	string	Apple Pay nonce signature

返回结构

参数	类型	备注
activation_data	string	Apple Pay activation data
encrypted_pass_data	string	Apple Pay encrypted pass data
ephemeral_public_key	string	Apple Pay ephemeral public key

共享卡接口

✨ 共享卡说明

共享卡是一种 无需预先充值的虚拟卡解决方案。商户只需在我方平台预先存入资金，即可为旗下用户批量创建共享卡。卡片按日限额管理，单卡每日消费不得超过设定额度。

卡片使用流程说明：

商户可为名下用户创建共享卡，创建时无需向卡片单独充值。
当用户使用该卡发起消费时，Visa 会实时向我方发送交易授权请求。
我方将该交易授权请求通过 Webhook 回调发送给商户。
商户需在 3秒内响应交易授权请求，并判断对应用户的账户余额是否充足。
若余额充足，商户需立即 冻结或扣除用户资金，并返回授权通过及用户剩余额度。
返回字段中的用户剩余额度为： min(每日限额 - 已消费金额, 用户当前余额)

优势：

无需用户逐卡充值，简化资金管理；
实时授权控制，保障交易安全；
灵活的额度管理，提高资金使用效率。
仅对接共享卡，贵司只需要对接开卡/查卡/查流水/webhook即可满足运营条件

共享卡交易授权流程图

# 使用 `api_secret` 进行**HMAC-sha512**加密 *

$ echo -n 'api_key=cA66c6dd9523835-kSSRJkJSJNDNRSkND-8s66c6dd952384f-4g66c6dd9523852&timestamp=1724326435' | openssl dgst -sha512 -hmac '6566c6dd9523856-kSSRJkJSJNDNRSkNk-Dv66c6dd952385e-kSSRJkJSccJckDLJL-kn66c6dd9523866'

(stdin)= 0354954708f6a0f774489416d0aa0efab8d26583a6501b2e7786b7b00a6634c1525df6e9fe8191d238deb644da1537c39806e52f8e2df20eadfe21d521f4193d

# PHP 加密方法 

$api_key = 'cA66c6dd9523835-kSSRJkJSJNDNRSkND-8s66c6dd952384f-4g66c6dd9523852';
$timestamp = '1724326435';
$api_secret = '6566c6dd9523856-kSSRJkJSJNDNRSkNk-Dv66c6dd952385e-kSSRJkJSccJckDLJL-kn66c6dd9523866';
$data = "api_key={$api_key}&timestamp={$timestamp}";

$signature = hash_hmac('sha512', $data, $api_secret);
echo $signature;

$ curl -X POST https://debit.xxx.com \
  -H "Content-Type: application/json" \
  -H "signature: 0354954708f6a0f774489416d0aa0efab8d26583a6501b2e7786b7b00a6634c1525df6e9fe8191d238deb644da1537c39806e52f8e2df20eadfe21d521f4193d" \
  -d '{
    "api_key": "cA66c6dd9523835-kSSRJkJSJNDNRSkND-8s66c6dd952384f-4g66c6dd9523852",
    "timestamp": 1724326435
}'

第一步: 参数顺序排序后拼接

对所有请求参数（不包括 sign 参数），按照参数名ASCII码表升序顺序排序。如：foo=1， bar=2， foo_bar=3， baz=4 排序后的顺序是 bar=2， baz=4， foo=1， foo_bar=3。将参数列表排列成一个 string。用 & 分隔每个参数。对于上述参数，签名 payload 如下所示：

api_key=cA66c6dd9523835-kSSRJkJSJNDNRSkND-8s66c6dd952384f-4g66c6dd9523852&timestamp=1724325685&user_id=10000008984

第二步: 计算签名

curl 请求 demo

签名方式(与通用接口存在差异)

API Key API 访问密钥
Secret Key 签名认证加密所使用的密钥

这两个配置同通用接口配置, 区别于通用接口签名不是签名方式而是签名放置的位置

算出签名后放在 header 头中参数 signature : 0354954708f6a0f774489416d0aa0efab8d26583a6501b2e7786b7b00a6634c1525df6e9fe8191d238deb644da1537c39806e52f8e2df20eadfe21d521f4193d

📌 交易授权接口

{
  "direction": -1,
  "card_pool_id": 10275,
  "exchange_rate": "1",
  "transaction_no": "AH1776438231544897536",
  "vendor_order_no": "965168053263315",
  "transaction_type": 1,
  "bill_amount": "20.00",
  "bill_currency_id": 10007,
  "transaction_amount": "20.00",
  "transaction_currency_id": 1,
  "trade_merchant": "SIMULATOR>SINGAPORE SG",
  "mcc":"6011",
  "trade_country": "CN",
  "tx_fee": "0.04",
  "is_cross_border": 0
}

curl -X POST https://xxxx.xxx.com/webhook/authorization \
  -H "Content-Type: application/json" \
  -H "signature: 0354954708f6a0f774489416d0aa0efab8d26583a6501b2e7786b7b00a6634c1525df6e9fe8191d238deb644da1537c39806e52f8e2df20eadfe21d521f4193d" \
  -d '{
    "direction": -1,
    "card_pool_id": 10275,
    "exchange_rate": "1",
    "transaction_no": "AH1776438231544897536",
    "vendor_order_no": "965168053263315",
    "transaction_type": 1,
    "bill_amount": "20.00",
    "bill_currency_id": 10007,
    "transaction_amount": "20.00",
    "transaction_currency_id": 1,
    "trade_merchant": "SIMULATOR>SINGAPORE SG",
    "mcc":"6011",
    "trade_country": "CN",
    "tx_fee": "0.04",
    "is_cross_border": 0,
    "timestamp":1756109301
}'

{
  "status": 200,
  "msg": "ok",
  "extend": {
    "date": "2025-05-14 15:54:10",
    "unique": "68244c220e38d1704722825",
    "runtime": "289.62 ms"
  },
  "data": {
    "ledger_balance": "300517175.60",
    "available_balance": "9980.00"
  }
}

此接口需要基于direction参数判断处理逻辑，1加钱，-1减钱，0 其他 (查询余额) ; 您的减钱操作需要同步认证，但退款建议通过交易记录确认!!!

操作成功 status = 200，操作失败：status != 200 详见授权错误码

HTTP请求:

POST /webhook/authorization

请求参数

字段名	类型	说明
`direction`	`int`	交易方向：`1` 增加资产，`-1` 扣除资产，`0` 其他 (查询余额)
`card_pool_id`	`int`	卡池 ID
`exchange_rate`	`string`	汇率（如：`usdt / jpy`）
`transaction_no`	`string`	四方交易唯一 ID（唯一标识每一笔交易）
`vendor_order_no`	`string`	卡商交易 ID
`transaction_type`	`int`	仅需要关注direction字段，当前字段为备注交易类型说明： 1 消费扣款 2 押金扣除 3 退回押金 4 退款 5 查询余额 7 部分退款
`bill_amount`	`string`	三方货币金额（如 `200.00` USDT）
`bill_currency_id`	`int`	三方货币 ID（如 USDT 为 10007）
`transaction_amount`	`string`	实际交易金额（如 `10000.00` 日元）
`transaction_currency_id`	`int`	实际交易币种 ID（如日元为 5）
`trade_merchant`	`string`	交易商户名称
`trade_location`	`string`	商户地址
`mcc`	`string`	mcc
`rrn`	`string`	rrn
`trade_country`	`string`	交易国家地区(Alpha-2代码)
`tx_fee`	`string`	手续费 (包含所有手续费)
`is_cross_border`	`int`	是否跨境 0否 1是
`timestamp`	`int`	时间戳

返回结构

字段名	类型	说明
`ledger_balance`	string	总余额（账面余额）
`available_balance`	string	可用余额 , min(每日限额 - 已消费金额, 用户当前余额)

授权错误码 (status)

值	含义
1000	卡不存在
1001	内部服务器错误
1002	卡配置不存在
1003	超出单笔消费限额
1004	超出每日消费限额
1005	用户资产不足
1006	授权失败
1007	交易记录已经授权
1008	交易记录不存在
1009	新增交易通知记录失败
1010	更新交易通知记录失败
1011	更新交易授权记录失败
1012	新增 3DS 验证通知记录参数失败
1020	用户被风控，限制交易

📌 交易记录回调

{
  "bill_id":179734,
  "channel_id":101,
  "user_id":11632498,
  "card_pool_id":100183,
  "vendor_id":6668,
  "vendor_card_id":1000011,
  "trade_merchant":"DON DON DONKI KL HK",
  "currency_amount":"561.10000000",
  "currency_id":6,
  "trade_begin_time":1755330459,
  "trade_time":1755330459,
  "direction":1,
  "tx_amount":"71.83000000",
  "tx_item_id":10007,
  "fee":"0.00000000",
  "usdt_amount":"71.83000000",
  "refund_amount":"0.00000000",
  "bill_type":1,
  "vendor_bill_type":"1",
  "status":1,
  "fail_code":0,
  "vendor_order_no":"585228280567436",
  "is_cross_border":1,
  "rrn":"125852282805674",
  "api_key":"5G66cd41ab99651-EREDRERSkkSNRLRJJ-YW66cd41ab99669-jY66cd41ab9966c",
  "timestamp":1755330472
}

curl -X POST \
  https://xxxx.xxx.com/webhook/syncUserBill \
  -H 'Content-Type: application/json' \
  -d '{
    "bill_id": 179734,
    "channel_id": 101,
    "user_id": 11632498,
    "card_pool_id": 100183,
    "vendor_id": 6668,
    "vendor_card_id": 1000011,
    "trade_merchant": "DON DON DONKI KL HK",
    "currency_amount": "561.10000000",
    "currency_id": 6,
    "trade_begin_time": 1755330459,
    "trade_time": 1755330459,
    "direction": 1,
    "tx_amount": "71.83000000",
    "tx_item_id": 10007,
    "fee": "0.00000000",
    "usdt_amount": "71.83000000",
    "refund_amount": "0.00000000",
    "bill_type": 1,
    "vendor_bill_type": "1",
    "status": 1,
    "rrn": "185228280567431",
    "fail_code": 0,
    "vendor_order_no": "585228280567436",
    "is_cross_border": 1,
    "api_key": "5G66cd41ab99651-EREDRERSkkSNRLRJJ-YW66cd41ab99669-jY66cd41ab9966c",
    "timestamp": 1755330472
  }'

{
  "status": 200,
  "msg": "ok",
  "extend": {
    "date": "2025-05-14 15:54:10",
    "unique": "68244c220e38d1704722825",
    "runtime": "289.62 ms"
  },
  "data": true
}

此接口不支持拒绝，请确认返回 status = 200

HTTP请求:

POST /webhook/syncUserBill

请求参数

字段名	类型	说明
bill_id	int	账单ID
user_id	string	自定义用户ID
card_pool_id	int	卡池ID
vendor_id	int	卡商ID
vendor_card_id	int	卡商卡ID
trade_merchant	string	交易商户名称
currency_amount	string	消费金额（法币）
currency_id	int	消费货币ID
trade_begin_time	int	交易开始时间（Unix时间戳）
trade_time	int	交易时间（Unix时间戳）
direction	int	交易方向 1 付款 2 收款（注意⚠️该接口字段 1 减钱 2 加钱）
tx_amount	string	交易结算金额（卡的币种）
tx_item_id	int	交易结算币种ID
fee	string	手续费
rrn	string	rrn
usdt_amount	string	折合USDT金额
refund_amount	string	退款金额
bill_type	int	账单类型 1 消费 2 充值 3 取款 4 退款
vendor_bill_type	int	卡商账单类型 1 授权消费 3 充值 4 取款 5 退款 8 交易预冻结 9 结算调整
status	int	状态 1 成功 2 取消 4 失败
fail_code	int	失败代码（枚举见附近）
vendor_order_no	string	卡商订单号
is_cross_border	int	是否跨境交易 1是 0否

结算调整

扣款：当接收到 bill_type = 1，vendor_bill_type = 9，direction = 1 的交易记录时，说明卡商那边发起了结算调整的扣款，这时就需要对用户进行追加扣款

退款：当接收到 bill_type = 4，status = 1，direction = -1 的交易记录时，说明平台这边已经完成了退款，可以给用户进行退款了

返回结构

📌 3DS 验证通知

此接口用于卡确认认证码，认证详情商户自行发验证码，短信/邮件/推送都可，告知到用户验证码时间有限，请及时同步

HTTP请求:

POST /webhook/verificationCode
事件 otp_notification
当卡3DS 设置的是 SMS验证, 需要通过 SMS 进行身份验证时触发.

{
  "event_type": "otp_notification",
  "destination": "+817092175541",
  "code": "871762",
  "card_no": "4466********3447",
  "trade_merchant": "HTTPS://HUNGRYPANDA.CO",
  "amount": "2351",
  "currency": "JPY",
  "event_time": 1745478407,
  "card_pool_id": 10285,
  "timestamp": 1749865540,
  "api_key": "5G66cd41ab99651-xxxx"
}

curl -X POST https://xxxx.xxx.com/webhook/verificationCode \
  -H "Content-Type: application/json" \
  -H "signature: 0354954708f6a0f774489416d0aa0efab8d26583a6501b2e7786b7b00a6634c1525df6e9fe8191d238deb644da1537c39806e52f8e2df20eadfe21d521f4193d" \
  -d '{
  "event_type": "otp_notification",
  "destination": "+817092175541",
  "code": "871762",
  "card_no": "4466********3447",
  "trade_merchant": "HTTPS://HUNGRYPANDA.CO",
  "amount": "2351",
  "currency": "JPY",
  "event_time": 1745478407,
  "card_pool_id": 10285,
  "timestamp": 1749865540,
  "api_key": "5G66cd41ab99651-xxxx"
}'

{
  "status": 200,
  "msg": "ok",
  "extend": {
    "date": "2025-05-14 15:54:10",
    "unique": "68244c220e38d1704722825",
    "runtime": "289.62 ms"
  },
  "data": true
}

请求参数

字段名	类型	说明
`event_type`	`string`	otp_notification
`destination`	`string`	目标 - 手机号
`code`	`string`	验证码
`card_no`	`string`	脱敏卡号
`trade_merchant`	`string`	消费商户名称
`amount`	`int`	消费金额
`currency`	`string`	币种名称
`event_time`	`int`	时间秒戳
`card_pool_id`	`int`	卡池 ID
`timestamp`	`int`	时间戳
`api_key`	`int`	api key

事件 card_token_passcode
提供卡片 token 認證用的 passcode, 如绑定Apply pay

{
  "event_type": "card_token_passcode",
  "destination": "+818038219371",
  "code": "643717",
  "card_no": "",
  "trade_merchant": "APPLE_PAY",
  "amount": 0,
  "currency": "",
  "event_time": 1745478407,
  "card_pool_id": 10285,
  "timestamp": 1749865540,
  "api_key": "5G66cd41ab99651-xxxx"
}

请求参数

字段名	类型	说明
`event_type`	`string`	card_token_passcode
`destination`	`string`	目标 - 手机号
`code`	`string`	验证码
`card_no`	`string`	脱敏卡号
`trade_merchant`	`string`	消费商户名称
`amount`	`int`	消费金额
`currency`	`string`	币种名称
`event_time`	`int`	时间秒戳
`card_pool_id`	`int`	卡池 ID
`timestamp`	`int`	时间戳
`api_key`	`int`	api key

事件 oob_notification
当交易正在进行 3DS OOB 验证, 质询流程并需要持卡人验证时触发, in App 授权后调用 [#3ds-oob]

{
  "event_type": "oob_notification",
  "destination": "",
  "code": "",
  "card_no": "",
  "trade_merchant": "HTTPS://HUNGRYPANDA.CO",
  "amount": "2351",
  "currency": "JPY",
  "event_time": 1745478407,
  "card_pool_id": 10285,
  "timestamp": 1749865540,
  "api_key": "5G66cd41ab99651-xxxx"
}

请求参数

字段名	类型	说明
`event_type`	`string`	oob_notification
`destination`	`string`	目标
`code`	`string`	验证码
`card_no`	`string`	脱敏卡号
`trade_merchant`	`string`	消费商户名称
`amount`	`int`	消费金额
`currency`	`string`	币种名称
`event_time`	`int`	时间秒戳
`card_pool_id`	`int`	卡池 ID
`authentication_id`	`string`	验证ID
`transaction_id`	`string`	交易ID
`timestamp`	`int`	时间戳
`api_key`	`int`	api key

返回结构

3DS OOB验证

{
  "status": 200,
  "msg": "ok",
  "extend": {
    "date": "2025-05-12 11:39:19",
    "unique": "68216d66f33de1009014995",
    "runtime": "177.14 ms"
  },
  "data": {
    "card_pool_id": 10060
  },
  "microtime": 1747021159173
}

HTTP请求:

POST /oob3DSAuthentication

请求参数

参数	取值	必传	类型	备注
card_pool_id	10060	是	int	卡池 ID - (卡池唯一标识)
transaction_id	d2431e2c-317b-47e3-a920-257e950f3ed5	是	string	交易ID (从oob_notification 通知中获取)
approve	1	是	int	是否同意 1同意 0拒绝
authentication_id	96e1aa98-ad78-4a8b-af44-60563149c7f1	是	string	验证ID(从oob_notification 通知中获取)
request_log_id	L1718217498410262528	是	string	调试日志标识
api_key	5G66cd41ab99651-EREDRERS	是	string	apiKey
timestamp	1746783841	是	int	请求时间戳秒
sign	9c062a8d614c84d0ea6debb...	是	string	签名

返回结构

参数	类型	备注
card_pool_id	int	卡池 ID - (卡池唯一标识)

Token 通知

此接口用于接收钱包 Token 生命周期通知，目前包含 Token 创建成功、Token 创建失败、Token 状态变更。

HTTP请求:

POST /webhook/token
事件 card_token_provisioned
钱包 Token 创建成功时触发。

{
  "event_type": "card_token_provisioned",
  "idempotency_key": "c35cc903-8e28-4de8-9d41-5a437fc6883b",
  "card_pool_id": 10285,
  "vendor_business_card_id": "01JSBDEFHWG9W3K1W1XTP174AC",
  "vendor_customer_no": "01JSEB6VG306N6RX9J37NY8QMT",
  "last_four_digits": "3447",
  "token_requestor": "APPLE_PAY",
  "token_requestor_id": "40010030273",
  "token_type": "SECURE_ELEMENT",
  "token_opaque_id": "01JSNE6W81DJMX09W423MJAGF5",
  "destination": "+817092175541",
  "device_id": "0330548690FB0822",
  "method": "SMS",
  "event_time": 1745478407,
  "timestamp": 1749865540,
  "api_key": "5G66cd41ab99651-xxxx"
}

curl -X POST https://xxxx.xxx.com/webhook/token \
  -H "Content-Type: application/json" \
  -H "signature: 0354954708f6a0f774489416d0aa0efab8d26583a6501b2e7786b7b00a6634c1525df6e9fe8191d238deb644da1537c39806e52f8e2df20eadfe21d521f4193d" \
  -d '{
  "event_type": "card_token_provisioned",
  "idempotency_key": "c35cc903-8e28-4de8-9d41-5a437fc6883b",
  "card_pool_id": 10285,
  "vendor_business_card_id": "01JSBDEFHWG9W3K1W1XTP174AC",
  "vendor_customer_no": "01JSEB6VG306N6RX9J37NY8QMT",
  "last_four_digits": "3447",
  "token_requestor": "APPLE_PAY",
  "token_requestor_id": "40010030273",
  "token_type": "SECURE_ELEMENT",
  "token_opaque_id": "01JSNE6W81DJMX09W423MJAGF5",
  "destination": "+817092175541",
  "device_id": "0330548690FB0822",
  "method": "SMS",
  "event_time": 1745478407,
  "timestamp": 1749865540,
  "api_key": "5G66cd41ab99651-xxxx"
}'

{
  "status": 200,
  "msg": "ok",
  "extend": {
    "date": "2026-07-08 12:00:00",
    "unique": "686de84000000000000004",
    "runtime": "88.23 ms"
  },
  "data": true
}

card_token_provisioned 请求参数

字段名	类型	说明
`event_type`	`string`	card_token_provisioned
`idempotency_key`	`string`	幂等键
`card_pool_id`	`int`	卡池 ID
`vendor_business_card_id`	`string`	卡商业务卡 ID
`vendor_customer_no`	`string`	卡商用户 ID
`last_four_digits`	`string`	卡号后四位
`token_requestor`	`string`	Token 请求方
`token_requestor_id`	`string`	Token 请求方 ID
`token_type`	`string`	Token 类型
`token_opaque_id`	`string`	Token Opaque ID
`destination`	`string`	验证方式信息
`device_id`	`string`	设备 ID
`method`	`string`	验证方式
`event_time`	`int`	事件时间戳（秒）
`timestamp`	`int`	请求时间戳
`api_key`	`string`	api key

事件 card_token_provisioning_failed
钱包 Token 创建失败时触发。

{
  "event_type": "card_token_provisioning_failed",
  "idempotency_key": "c35cc903-8e28-4de8-9d41-5a437fc6883b",
  "card_pool_id": 10285,
  "vendor_business_card_id": "01JSBDEFHWG9W3K1W1XTP174AC",
  "vendor_customer_no": "01JSEB6VG306N6RX9J37NY8QMT",
  "last_four_digits": "3447",
  "token_requestor": "APPLE_PAY",
  "token_requestor_id": "40010030273",
  "token_type": "SECURE_ELEMENT",
  "token_opaque_id": "01JSNE6W81DJMX09W423MJAGF5",
  "failed_provision_reason": "INVALID_CVV",
  "event_time": 1745478407,
  "timestamp": 1749865540,
  "api_key": "5G66cd41ab99651-xxxx"
}

card_token_provisioning_failed 请求参数

字段名	类型	说明
`event_type`	`string`	card_token_provisioning_failed
`idempotency_key`	`string`	幂等键
`card_pool_id`	`int`	卡池 ID
`vendor_business_card_id`	`string`	卡商业务卡 ID
`vendor_customer_no`	`string`	卡商用户 ID
`last_four_digits`	`string`	卡号后四位
`token_requestor`	`string`	Token 请求方
`token_requestor_id`	`string`	Token 请求方 ID
`token_type`	`string`	Token 类型
`token_opaque_id`	`string`	Token Opaque ID
`failed_provision_reason`	`string`	Token 创建失败原因
`event_time`	`int`	事件时间戳（秒）
`timestamp`	`int`	请求时间戳
`api_key`	`string`	api key

事件 card_token_status_changed
钱包 Token 状态变更时触发。

{
  "event_type": "card_token_status_changed",
  "idempotency_key": "c35cc903-8e28-4de8-9d41-5a437fc6883b",
  "card_pool_id": 10285,
  "vendor_business_card_id": "01JSBDEFHWG9W3K1W1XTP174AC",
  "vendor_customer_no": "01JSEB6VG306N6RX9J37NY8QMT",
  "token_requestor_id": "40010030273",
  "token_opaque_id": "01JSNE6W81DJMX09W423MJAGF5",
  "previous_status": "INACTIVE",
  "current_status": "ACTIVE",
  "event_time": 1745478407,
  "timestamp": 1749865540,
  "api_key": "5G66cd41ab99651-xxxx"
}

card_token_status_changed 请求参数

字段名	类型	说明
`event_type`	`string`	card_token_status_changed
`idempotency_key`	`string`	幂等键
`card_pool_id`	`int`	卡池 ID
`vendor_business_card_id`	`string`	卡商业务卡 ID
`vendor_customer_no`	`string`	卡商用户 ID
`token_requestor_id`	`string`	Token 请求方 ID
`token_opaque_id`	`string`	Token Opaque ID
`previous_status`	`string`	变更前状态
`current_status`	`string`	变更后状态
`event_time`	`int`	事件时间戳（秒）
`timestamp`	`int`	请求时间戳
`api_key`	`string`	api key

附件

tx_item_id 卡结算货币ID

tx_item_id	代码	名称
1	usd	美元
6	hkd	港元
10007	usdt	泰达币

item_id 结算货币ID

item_id	代码	名称
10007	usdt	泰达币
10005	btc	比特币
10003	eth	以太坊

currency_id 法币ID

currency_id	代码	法币名称
1	usd	美元
2	cny	人民币
3	dkk	丹麦克朗
4	krw	韩元
5	jpy	日元
6	hkd	港元
7	aed	阿联酋迪拉姆
8	vnd	越南盾
9	thb	泰铢
10	sgd	新加坡元
11	php	菲律宾比索
12	idr	印尼盾
13	ngn	尼日利亚奈拉
14	mmk	缅元
15	try	土耳其里拉
16	twd	新台币
17	myr	马来西亚林吉特
18	eur	欧元
19	gbp	英镑
20	rub	俄罗斯卢布
21	amd	亚美尼亚德拉姆
22	syp	叙利亚镑
23	ugx	乌干达先令
24	aud	澳大利亚元
25	nzd	新西兰元
26	inr	印度卢比
27	brl	巴西雷亚尔
28	cad	加拿大元
29	chf	瑞士法郎
30	cTest	---
31	mop	澳门元
32	afn	阿富汗尼
33	all	阿尔巴尼亚列克
34	aoa	安哥拉宽扎
35	ars	阿根廷比索
36	azn	阿塞拜疆马纳特
37	bam	波斯尼亚可兑换马克
38	bdt	孟加拉塔卡
39	bgn	保加利亚列弗
40	bhd	巴林第纳尔
41	bif	布隆迪法郎
42	bnd	文莱元
43	bob	玻利维亚诺
44	bwp	博茨瓦纳普拉
45	byn	白俄罗斯卢布
46	bzd	伯利兹元
47	cdf	刚果法郎
48	clp	智利比索
49	cop	哥伦比亚比索
50	crc	哥斯达黎加科朗
51	czk	捷克克朗
52	djf	吉布提法郎
53	dop	多米尼加比索
54	dzd	阿尔及利亚第纳尔
55	egp	埃及镑
56	ern	厄立特里亚纳克法
57	etb	埃塞俄比亚比尔
58	fjd	斐济元
59	gel	格鲁吉亚拉里
60	ghs	加纳塞地
61	gip	直布罗陀镑
62	gmd	冈比亚达拉西
63	gnf	几内亚法郎
64	gtq	危地马拉格查尔
65	gyd	圭亚那元
66	hnl	洪都拉斯伦皮拉
67	htg	海地古德
68	huf	匈牙利福林
69	ils	以色列新谢克尔
70	iqd	伊拉克第纳尔
71	irr	伊朗里亚尔
72	isk	冰岛克朗
73	jmd	牙买加元
74	jod	约旦第纳尔
75	kes	肯尼亚先令
76	kgs	吉尔吉斯斯坦索姆
77	khr	柬埔寨瑞尔
78	kmf	科摩罗法郎
79	kpw	朝鲜圆
80	kwd	科威特第纳尔
81	kyd	开曼元
82	kzt	哈萨克斯坦坚戈
83	lak	老挝基普
84	lbp	黎巴嫩镑
85	lkr	斯里兰卡卢比
86	lrd	利比里亚元
87	lsl	莱索托洛蒂
88	lyd	利比亚第纳尔
89	mad	摩洛哥迪拉姆
90	mdl	摩尔多瓦列伊
91	mga	马达加斯加阿里亚里
92	mkd	北马其顿第纳尔
93	mru	毛里塔尼亚乌吉亚
94	mur	毛里求斯卢比
95	mvr	马尔代夫拉菲亚
96	mwk	马拉维克瓦查
97	mxn	墨西哥比索
98	mzn	莫桑比克梅蒂卡尔
99	nad	纳米比亚元
100	nio	尼加拉瓜科多巴
101	nok	挪威克朗
102	npr	尼泊尔卢比
103	omr	阿曼里亚尔
104	pab	巴拿马巴波亚
105	pen	秘鲁索尔
106	pgk	巴布亚新几内亚基那
107	pkr	巴基斯坦卢比
108	pln	波兰兹罗提
109	pyg	巴拉圭瓜拉尼
110	qar	卡塔尔里亚尔
111	ron	罗马尼亚列伊
112	rsd	塞尔维亚第纳尔
113	rwf	卢旺达法郎
114	sar	沙特里亚尔
115	sbd	所罗门群岛元
116	scr	塞舌尔卢比
117	sdg	苏丹镑
118	sek	瑞典克朗
119	shp	圣赫勒拿镑
120	sll	塞拉利昂利昂
121	sos	索马里先令
122	srd	苏里南元
123	ssp	南苏丹镑
124	std	圣多美和普林西比多布拉
125	stn	圣多美和普林西比多布拉（新）
126	szl	斯威士兰里兰吉尼
127	tjs	塔吉克斯坦索莫尼
128	tmt	土库曼斯坦马纳特
129	tnd	突尼斯第纳尔
130	top	汤加潘加
131	ttd	特立尼达和多巴哥元
132	tzs	坦桑尼亚先令
133	uah	乌克兰格里夫纳
134	uyu	乌拉圭比索
135	uzs	乌兹别克斯坦索姆
136	ves	委内瑞拉主权玻利瓦尔
137	vuv	瓦努阿图瓦图
138	wst	萨摩亚塔拉
139	xaf	中非金融合作法郎
140	xcd	东加勒比元
141	xof	西非金融合作法郎
142	xpf	太平洋法郎
143	yer	也门里亚尔
144	zar	南非兰特
145	zmw	赞比亚克瓦查
146	zwl	津巴布韦元
147	bmd	百慕大元
148	mnt	蒙古图格里克

商户类别商户类别码码 (MCC) 是什么？

MCC 及其定义由国际标准化组织 (ISO) 制定。

支付处理商会根据商家的业务类型、风险等级等因素分配 MCC，以此决定收费标准。虽然大多数发卡机构能够识别绝大多数 MCC，但部分卡组织有自己特定的 MCC 变种。商家本身无法自行指定 MCC，但可以请求其支付处理商分配特定 MCC。如果商家满足特定 MCC 的分配条件，则其请求可能会被批准。

MCC 在交易处理中的作用

简而言之，发卡行和支付处理商能够通过 MCC 了解全程如何处理交易，这包括：

交换费交换费是商家为了能够接受银行卡付款而需支付的费用。交换费的设定通常遵循卡组织制定的普遍标准，但因 MCC 的不同，费率会有所不同。从属于特定类别的商家购物时或多或少会产生交换费。例如，对于欺诈率和撤单率较低的商家类别，其 MCC 对应的交换费会相对较低。反之，对于高风险的商家类别，其 MCC 对应的交换费则相对较高。
持卡人费用对于特定 MCC 的银行卡支付交易（如与政府相关的交易），一些类型的商家可以向持卡人收取服务费。
高风险商家身份验证商家收单行和支付处理商通常会根据商家类型来评估其相关风险，从而帮助确定费用。虽然 Visa 高级授权 (VAA) 或 Mastercard 智能决策评分 (MDIS) 用于确定风险评分的方法不是公开信息，但交易中使用的 MCC 可能会用于风险评分等式中。
撤单保护一些 MCC 无法获得同等程度的欺诈保护，尤其是在无卡 (CNP) 交易中。这通常适用于欺诈率较高，因而撤单率也较高的商家。例如，一些高风险类型的电话营销公司和药店的撤单费也较高。
税务用途 MCC 还可用于税务事项，指示持卡人某笔交易是否需要向美国国税局报备。在大多数情况下，商家需要报备服务购买信息，但不需要报备商品购买信息。

MCC 为何如此重要？

MCC 对支付流程非常重要，原因有很多，包括：

设置支出控制您可以使用 MCC 来管理已发行的卡，限制其用于某些商家类型或只能用于某些商家类型。例如，如果您正在创建一个差旅费平台，您可以设置支出控制，让您的卡只能用于具有与差旅有关的 MCC 消费。一些 Stripe 发卡行合作伙伴要求我们在程序层面上拦截赌博等高风险的 MCC。
收集持卡人的消费数据每笔交易以及授权对象都有 MCC 数据和有关交易的其他有用信息，包括金额、授权方式以及用卡商家的其他详细信息。
奖励持卡人 MCC 可用于奖励持卡人。例如，如果您准备针对企业办公用品为持卡人提供 3% 的返现，那么当商家发生具有专用于办公用品的 MCC 的任何交易时，您都会收到发放返现奖励的通知。
确定交换费 MCC 确定交易类型，交易类型决定交易所适用的交换费。高风险企业通常支付更高的交换费，这降低了企业从每笔交易中获得的利润。
跨境交易 MCC 可以影响跨境交易的处理方式，包括货币兑换费用和接受规则，对涉及高风险业务的交易收取更高的费用。

MCC 列表

MCC 的不足之处在于，并不存在一套被所有实体和组织广泛接受并采用的商户类别码标准。然而，MCC 的分类范围却是统一的。以下是各个行业的代码范围概览：

0001–1499：农业服务
1500–2999：承包服务
4000–4799：运输服务
4800–4999：公用事业服务
5000–5599：零售店服务
5600–5699：服装商店
5700–7299：其他商店
7300–7999：商业服务
8000–8999：专业服务及会员组织
9000–9999：政府服务

Mcc	描述
9950	Intra-Company Purchases
9702	Emergency Services (GCAS) (Visa use only)
9406	Government-Owned Lotteries (Non-U.S. region)
9405	U.S. Federal Government Agencies or Departments
9402	Postal Services – Government Only
9399	Government Services (Not Elsewhere Classified)
9311	Tax Payments
9223	Bail and Bond Payments
9222	Fines
9211	Court Costs, Including Alimony and Child Support
8999	Professional Services (Not Elsewhere Classified)
8931	Accounting, Auditing, and Bookkeeping Services
8911	Architectural, Engineering, and Surveying Services
8734	Testing Laboratories (Non-Medical Testing)
8699	Membership Organizations (Not Elsewhere Classified)
8675	Automobile Associations
8661	Religious Organizations
8651	Political Organizations
8641	Civic, Social, and Fraternal Associations
8398	Charitable Social Service Organizations
8351	Child Care Services
8299	Schools and Educational Services (Not Elsewhere Classified)
8249	Vocational and Trade Schools
8244	Business and Secretarial Schools
8241	Correspondence Schools
8220	Colleges, Universities, Professional Schools, and Junior Colleges
8211	Elementary and Secondary Schools
8111	Legal Services and Attorneys
8099	Medical Services and Health Practitioners (Not Elsewhere Classified)
8071	Medical and Dental Laboratories
8062	Hospitals
8050	Nursing and Personal Care Facilities
8049	Podiatrists and Chiropodists
8043	Opticians, Optical Goods, and Eyeglasses
8042	Optometrists and Ophthalmologists
8041	Chiropractors
8031	Osteopaths
8021	Dentists and Orthodontists
8011	Doctors and Physicians (Not Elsewhere Classified)
7999	Recreation Services (Not Elsewhere Classified)
7998	Aquariums, Seaquariums, Dolphinariums, and Zoos
7997	Membership Clubs (Sports, Recreation, Athletic), Country Clubs, and Private Golf Courses
7996	Amusement Parks, Circuses, Carnivals, and Fortune Tellers
7995	Betting, including Lottery Tickets, Casino Gaming Chips, Off-Track Betting, Wagers at Race Tracks and games of chance to win prizes of monetary value
7994	Video Game Arcades/Establishments
7993	Video Amusement Game Supplies
7992	Public Golf Courses
7991	Tourist Attractions and Exhibits
7941	Commercial Sports, Professional Sports Clubs, Athletic Fields, and Sports Promoters
7933	Bowling Alleys
7932	Billiard and Pool Establishments
7929	Bands, Orchestras, and Miscellaneous Entertainers (Not Elsewhere Classified)
7922	Ticket Agencies and Theatrical Producers (Except Motion Pictures)
7911	Dance Halls, Studios and Schools
7841	DVD/Video Tape Rental Stores
7832	Motion Picture Theaters
7829	Motion Picture and Video Tape Production and Distribution
7802	Government-Licensed Horse/Dog Racing (US Region only)
7801	Government Licensed On-Line Casinos (On-Line Gambling) (US Region only)
7800	Government-Owned Lotteries (US Region only)
7699	Miscellaneous Repair Shops and Related Services
7692	Welding Services
7641	Furniture – Reupholstery, Repair, and Refinishing
7631	Watch, Clock and Jewelry Repair
7629	Electrical and Small Appliance Repair Shops
7623	Air Conditioning and Refrigeration Repair Shops
7622	Electronics Repair Shops
7549	Towing Services
7542	Car Washes
7538	Automotive Service Shops (Non-Dealer)
7535	Automotive Paint Shops
7534	Tire Retreading and Repair Shops
7531	Automotive Body Repair Shops
7523	Parking Lots, Parking Meters and Garages
7519	Motor Home and Recreational Vehicle Rentals
7513	Truck and Utility Trailer Rentals
7512	Automobile Rental Agency
7399	Business Services (Not Elsewhere Classified)
7395	Photofinishing Laboratories and Photo Developing
7394	Equipment, Tool, Furniture, and Appliance Rental and Leasing
7393	Detective Agencies, Protective Services, and Security Services, including Armored Cars, and Guard Dogs
7392	Management, Consulting, and Public Relations Services
7379	Computer Maintenance, Repair and Services (Not Elsewhere Classified)
7375	Information Retrieval Services
7372	Computer Programming, Data Processing, and Integrated Systems Design Services
7361	Employment Agencies and Temporary Help Services
7349	Cleaning, Maintenance, and Janitorial Services
7342	Exterminating and Disinfecting Services
7339	Stenographic and Secretarial Support
7338	Quick Copy, Reproduction, and Blueprinting Services
7333	Commercial Photography, Art, and Graphics
7321	Consumer Credit Reporting Agencies
7311	Advertising Services
7299	Miscellaneous Personal Services (Not Elsewhere Classified)
7298	Health and Beauty Spas
7297	Massage Parlors
7296	Clothing Rental – Costumes, Uniforms, Formal Wear
7278	Buying and Shopping Services and Clubs
7277	Counseling Services – Debt, Marriage, and Personal
7276	Tax Preparation Services
7273	Dating Services
7261	Funeral Services and Crematories
7251	Shoe Repair Shops, Shoe Shine Parlors, and Hat Cleaning Shops
7230	Beauty and Barber Shops
7221	Photographic Studios
7217	Carpet and Upholstery Cleaning
7216	Dry Cleaners
7211	Laundries – Family and Commercial
7210	Laundry, Cleaning, and Garment Services
7033	Trailer Parks and Campgrounds
7032	Sporting and Recreational Camps
7012	Timeshares
7011	Lodging – Hotels, Motels, Resorts, Central Reservation Services (Not Elsewhere Classified)
6540	Non-Financial Institutions – Stored Value Card Purchase/Load
6513	Real Estate Agents and Manager
6300	Insurance Sales, Underwriting, and Premiums
6211	Security Brokers/Dealers
6051	Non-Financial Institutions – Foreign Currency, Non-Fiat Currency (for example: Cryptocurrency), Money Orders (Not Money Transfer), Account Funding (not Stored Value Load), Travelers Cheques, and Debt Repayment
6012	Financial Institutions – Merchandise, Services, and Debt Repayment
6011	Financial Institutions – Automated Cash Disbursements
6010	Financial Institutions – Manual Cash Disbursements
5999	Miscellaneous and Specialty Retail Shops
5998	Tent and Awning Shops
5997	Electric Razor Stores – Sales and Service
5996	Swimming Pools – Sales and Service
5995	Pet Shops, Pet Foods and Supplies Stores
5994	News Dealers and Newsstands
5993	Cigar Stores and Stands
5992	Florists
5983	Fuel Dealers – Fuel Oil, Wood, Coal, and Liquefied Petroleum
5978	Typewriter Stores – Sales, Rentals, and Service
5977	Cosmetic Stores
5976	Orthopedic Goods – Prosthetic Devices
5975	Hearing Aids – Sales, Service, and Supply
5973	Religious Goods Stores
5972	Stamp and Coin Stores
5971	Art Dealers and Galleries
5970	Artist's Supply and Craft Shops
5969	Direct Marketing – Other Direct Marketers (Not Elsewhere Classified)
5968	Direct Marketing – Continuity/Subscription Merchant
5967	Direct Marketing – Inbound Teleservices Merchant
5966	Direct Marketing – Outbound Telemarketing Merchant
5965	Direct Marketing – Combination Catalog and Retail Merchant
5964	Direct Marketing – Catalog Merchant
5963	Door-To-Door Sales
5962	Direct Marketing – Travel-Related Arrangement Services
5960	Direct Marketing – Insurance Services
5950	Glassware/Crystal Stores
5949	Sewing, Needlework, Fabric and Piece Goods Stores
5948	Luggage and Leather Goods Stores
5947	Gift, Card, Novelty and Souvenir Shops
5946	Camera and Photographic Supply Stores
5945	Hobby, Toy, and Game Shops
5944	Jewelry Stores, Watches, Clocks, and Silverware Stores
5943	Stationery Stores, Office and School Supply Stores
5942	Book Stores
5941	Sporting Goods Stores
5940	Bicycle Shops – Sales and Service
5937	Antique Reproductions
5935	Wrecking and Salvage Yards
5933	Pawn Shops
5932	Antique Shops – Sales, Repairs, and Restoration Services
5931	Used Merchandise and Secondhand Stores
5921	Package Stores – Beer, Wine, and Liquor
5912	Drug Stores and Pharmacies
5818	Digital Goods – Large Digital Goods Merchant
5817	Digital Goods – Applications (Excludes Games)
5816	Digital Goods – Games
5815	Digital Goods Media – Books, Movies, Digital artwork/images, Music
5814	Fast Food Restaurant
5813	Drinking Places (Alcoholic Beverages) – Bars, Taverns, Nightclubs, Cocktail Lounges, and Discotheques
5812	Eating Places and Restaurants
5811	Caterers
5735	Record Stores
5734	Computer Software Stores
5733	Music Stores – Musical Instruments, Pianos, and Sheet Music
5732	Electronics Stores
5722	Household Appliance Stores
5719	Miscellaneous Home Furnishing Specialty Stores
5718	Fireplace, Fireplace Screens and Accessories Stores
5714	Drapery, Window Covering, and Upholstery Stores
5713	Floor Covering Stores
5712	Furniture, Home Furnishings, and Equipment Stores, Except Appliances
5699	Miscellaneous Apparel and Accessory Shops
5698	Wig and Toupee Stores
5697	Tailors, Seamstresses, Mending, and Alterations
5691	Men's and Women's Clothing Stores
5681	Furriers and Fur Shops
5661	Shoe Stores
5655	Sports and Riding Apparel Stores
5651	Family Clothing Stores
5641	Children's and Infants' Wear Stores
5631	Women's Accessory and Specialty Shops
5621	Women's Ready-To-Wear Stores..
5611	Men's and Boys' Clothing and Accessories Stores
5599	Miscellaneous Automotive, Aircraft, and Farm Equipment Dealers (Not Elsewhere Classified)
5598	Snowmobile Dealers
5592	Motor Homes Dealers
5571	Motorcycle Shops and Dealers
5561	Camper, Recreational and Utility Trailer Dealers
5552	Electric Vehicle Charging
5551	Boat Dealers
5542	Automated Fuel Dispensers
5541	Service Stations (With or without Ancillary Services)
5533	Automotive Parts and Accessories Stores
5532	Automotive Tire Stores
5521	Car and Truck Dealers (Used Only) Sales, Service, Repairs, Parts, and Leasing
5511	Car and Truck Dealers (New and Used) Sales, Service, Repairs, Parts, and Leasing
5499	Miscellaneous Food Stores – Convenience Stores and Specialty Markets
5462	Bakeries
5451	Dairy Products Stores
5441	Candy, Nut, and Confectionery Stores
5422	Freezer and Locker Meat Provisioners
5411	Grocery Stores and Supermarkets
5399	Miscellaneous General Merchandise
5331	Variety Stores
5311	Department Stores
5310	Discount Stores
5309	Duty Free Stores
5300	Wholesale Clubs
5271	Mobile Home Dealers
5262	Marketplaces
5261	Nurseries and Lawn and Garden Supply Stores
5251	Hardware Stores
5231	Glass, Paint, and Wallpaper Stores
5211	Lumber and Building Materials Stores
5200	Home Supply Warehouse Stores
5199	Nondurable Goods (Not Elsewhere Classified)
5198	Paints, Varnishes and Supplies
5193	Florists Supplies, Nursery Stock and Flowers
5192	Books, Periodicals and Newspapers
5172	Petroleum and Petroleum Products
5169	Chemicals and Allied Products (Not Elsewhere Classified)
5139	Commercial Footwear
5137	Men's, Women's, and Children's Uniforms and Commercial Clothing
5131	Piece Goods, Notions, and Other Dry Goods
5122	Drugs, Drug Proprietaries, and Druggist Sundries
5111	Stationery, Office Supplies, Printing and Writing Paper
5099	Durable Goods (Not Elsewhere Classified)
5094	Precious Stones and Metals, Watches and Jewelry
5085	Industrial Supplies (Not Elsewhere Classified)
5074	Plumbing and Heating Equipment and Supplies
5072	Hardware, Equipment and Supplies
5065	Electrical Parts and Equipment
5051	Metal Service Centers and Offices
5047	Medical, Dental, Ophthalmic and Hospital Equipment and Supplies
5046	Commercial Equipment (Not Elsewhere Classified)
5045	Computers and Computer Peripheral Equipment and Software
5044	Photographic, Photocopy, Microfilm Equipment and Supplies
5039	Construction Materials (Not Elsewhere Classified)
5021	Office and Commercial Furniture ...
5013	Motor Vehicle Supplies and New Parts
4900	Utilities – Electric, Gas, Water, and Sanitary
4899	Cable, Satellite and Other Pay Television/Radio/Streaming Services
4829	Money Transfer
4821	Telegraph Services
4816	Computer Network/Information Services
4814	Telecommunication Services, including Local and Long Distance Calls, Credit Card Calls, Calls Through Use of MagneticStripe-Reading Telephones, and Fax Services
4812	Telecommunication Equipment and Telephone Sales
4789	Transportation Services (Not Elsewhere Classified)
4784	Tolls and Bridge Fees
4723	Package Tour Operators – Germany Only
4722	Travel Agencies and Tour Operators
4582	Airports, Flying Fields, and Airport Terminals
4511	Airlines and Air Carriers (Not Elsewhere Classified)
4468	Marinas, Marine Service, and Supplies
4457	Boat Rentals and Leasing
4411	Steamship and Cruise Lines
4225	Public Warehousing and Storage – Farm Products, Refrigerated Goods, Household Goods, and Storage
4215	Courier Services – Air and Ground, and Freight Forwarders
4214	Motor Freight Carriers and Trucking – Local and Long Distance, Moving and Storage Companies, and Local Delivery Services
4131	Bus Lines
4121	Taxicabs and Limousines
4119	Ambulance Services
4112	Passenger Railways
4111	Local and Suburban Commuter Passenger Transportation, Including Ferries
4011	Railroads
3838	KIMPTON HOTELS
3837	HOSHINO RESORTS
3836	HAWTHORN BY WYNDHAM
3835	DOLCE HOTELS AND RESORTS
3834	BAYMONT INN & SUITES
3833	CANOPY
3832	CURIO HOTELS
3831	WALDORF
3830	PARK PLAZA HOTEL
3829	COUNTRY INN BY RADISSON
3828	COSMOPOLITAN OF LAS VEGAS
3827	GALT HOUSE
3826	AUTOGRAPH
3825	VDARA
3824	ARIA
3823	GRAND SIERRA RESORT
3822	CROSSLAND
3821	CARIBE ROYALE
3820	JUMEIRAH ESSEX HOUSE
3819	OXFORD SUITES
3818	MAINSTAY SUITES
3816	HOME2SUITES
3815	NICKELODEON FAMILY SUITES BY HOLIDAY INN
3814	THE ROOSEVELT HOTEL NY
3813	HOTEL INDIGO
3812	HYATT PLACE
3811	PREMIER INN
3808	LXR
3807	ELEMENT
3802	THE PALACE HOTEL
3801	WILDERNESS HOTEL AND RESORT
3800	HOMESTEAD SUITES
3799	HALE KOA HOTEL
3798	EMBASSY VACATION RESORT
3797	ATLANTIC CITY HILTON RESORTS
3796	PEPPERMILL HOTEL CASINO
3795	PARIS LAS VEGAS HOTEL
3794	GRAND CASINO HOTELS
3793	FLAMINGO HOTELS
3792	CLARIDGE CASINO HOTEL
3791	STAYBRIDGE SUITES
3790	RAFFLES HOTELS
3789	SMUGGLER'S NOTCH RESORT
3788	ALA MOANA HOTEL
3787	CARIBE ROYALE RESORTS
3786	OHANA HOTELS OF HAWAII
3785	OUTRIGGER HOTELS AND RESORTS
3784	FIRST HOSPITALITY HOTELS
3783	TOWN AND COUNTRY RESORT & CONVENTION CENTER
3782	ROSEN HOTELS AND RESORTS
3781	PATRICIA GRAND RESORT HOTELS
3780	DISNEY RESORTS
3779	W HOTELS
3778	FOUR POINTS HOTELS
3777	MANDALAY BAY RESORT
3776	NEVELE GRAND RESORT AND COUNTRY CLUB
3775	SANDS RESORT
3774	NEW YORK-NEW YORK HOTEL AND CASINO
3773	THE VENETIAN RESORT HOTEL CASINO
3772	NEMACOLIN WOODLANDS
3771	CAESAR'S HOTEL AND CASINO
3770	SPRINGHILL SUITES
3769	STRATOSPHERE HOTEL AND CASINO
3768	SILVER STAR HOTEL AND CASINO
3767	MAIN STREET STATION HOTEL AND CASINO
3766	FREMONT HOTEL AND CASINO
3765	BELLAGIO
3764	BEAU RIVAGE HOTEL AND CASINO
3763	CHATEAU ELAN WINERY AND RESORT
3762	WHISKEY PETE'S HOTEL AND CASINO
3761	PRIMADONNA HOTEL AND CASINO
3760	HALEKULANI HOTEL/WAIKIKI PARC
3759	THE ORCHID AT MAUNA LANI
3758	KAHALA MANDARIN ORIENTAL HOTEL
3757	CANYON RANCH
3755	THE HOMESTEAD
3754	AMELIA ISLAND PLANTATION
3753	GREENBRIAR RESORTS
3752	PEABODY HOTELS
3751	HOMEWOOD SUITES
3750	CROWNE PLAZA HOTELS
3749	THE BEVERLY HILLS HOTEL
3748	WELLESLEY INNS
3747	CLUBCORP/CLUBRESORTS
3746	THE ELIOT HOTEL
3745	ST. REGIS HOTEL
3744	CAREFREE RESORTS
3743	BILTMORE HOTEL & SUITES
3742	CLUB MED
3741	MILLENNIUM HOTELS
3740	TOWNEPLACE SUITES
3739	WOODSIDE HOTELS & RESORTS
3738	TROPICANA RESORT & CASINO
3737	RIVIERA HOTEL AND CASINO
3736	COLORADO BELLE/EDGEWATER RESORT
3735	MASTERS ECONOMY INNS
3734	HARVEY/BRISTOL HOTELS
3732	OPRYLAND HOTEL
3731	HARRAH'S HOTELS AND CASINOS
3730	MGM GRAND HOTEL
3729	JOHN ASCUAGA'S NUGGET
3728	BALLY'S HOTEL AND CASINO
3727	BROADMOOR HOTEL
3726	RIO SUITES
3725	SEA PINES RESORT
3724	INTER NOR HOTELS
3723	RICA HOTELS
3722	WYNDHAM
3721	HILTON CONRAD
3720	SOUTHERN SUN HOTELS
3719	PROTEA HOTELS
3718	KAROS HOTELS
3717	CITY LODGE HOTELS
3716	CARLTON HOTELS
3715	FAIRFIELD INN
3714	FOUR SEASONS HOTEL (AUSTRALIA)
3713	QUALITY PACIFIC HOTEL
3712	BUFFALO BILL'S HOTEL AND CASINO
3711	FLAG INNS (AUSTRALIA)
3710	THE RITZ-CARLTON
3709	SUPER 8 MOTELS
3708	VIRGIN RIVER HOTEL AND CASINO
3707	SHONEY'S INNS
3706	SHILO INNS
3705	SANDMAN INNS
3704	ROYCE HOTELS
3703	RESIDENCE INNS
3702	THE REGISTRY HOTELS
3701	LA MANSION DEL RIO
3700	MOTEL 6
3699	MIDWAY MOTOR LODGE
3698	HARLEY HOTELS
3697	FAIRFIELD HOTELS
3696	EXEL INNS
3695	EMBASSY SUITES
3694	ECONOMY INNS OF AMERICA
3693	DRURY INNS
3692	DOUBLETREE HOTELS
3691	DILLON INNS
3690	COURTYARD BY MARRIOTT
3689	CONSORT HOTELS
3688	COMPRI HOTELS
3687	CLARION HOTELS
3686	SUSSE CHALET
3685	BUDGETEL INNS
3684	BUDGET HOST INNS
3683	BRADBURY SUITES
3682	SAHARA HOTEL AND CASINO
3681	ADAMS MARK HOTELS
3680	HOTEIS OTHAN
3679	SILVER LEGACY HOTEL AND CASINO
3678	CUMULUS HOTELS
3677	CLIMAT DE FRANCE HOTELS
3676	MONTE CARLO HOTEL AND CASINO
3675	INTERHOTEL CEDOK
3674	RANTASIPI HOTELS
3673	IBUSZ HOTELS
3672	CAMPANILE HOTELS
3671	ARCTIA HOTELS
3670	ARCADE HOTELS
3669	ELDORADO HOTEL AND CASINO
3668	MARITIM HOTELS
3667	LUXOR HOTEL AND CASINO
3666	STAKIS HOTELS
3665	HAMPTON INNS
3664	FLAG INN
3663	HOTELES EL PRESIDENTE
3662	CIRCUS CIRCUS HOTEL AND CASINO
3661	METROPOLE HOTELS
3660	KNIGHTS INNS
3659	TAJ HOTELS INTERNATIONAL
3658	NEW OTANI HOTELS
3657	OBEROI HOTELS
3656	SARA HOTELS
3655	SCANDIC HOTELS
3654	LOEWS HOTELS
3653	PENTA HOTELS
3652	EMBASSY HOTELS
3651	IMPERIAL LONDON HOTEL
3650	RED ROOF INNS
3649	RADISSON HOTELS
3648	DE VERE HOTELS
3647	HUSA HOTELS
3646	SWALLOW HOTELS
3645	QUEENS MOAT HOUSES
3644	ECONO LODGES
3643	STEIGENBERGER HOTELS
3642	NOVOTEL HOTELS
3641	SOFITEL HOTELS
3640	HYATT HOTELS
3639	MOUNT CHARLOTTE THISTLE
3638	HOWARD JOHNSON
3637	RAMADA INNS
3636	SAROVA HOTELS
3635	RESO HOTELS
3634	SWISSOTEL
3633	RANK HOTELS
3632	THE PHOENICIAN
3631	SLEEP INN
3629	DAN HOTELS
3628	EXCALIBUR HOTEL AND CASINO
3627	EXTENDED STAY AMERICA
3626	STUDIO PLUS
3625	HOTEL UNIVERSALE
3624	LADY LUCK HOTEL AND CASINO
3623	DORINT HOTELS
3622	MERLIN HOTELS
3621	EXTENDED STAY
3620	BINION'S HORSESHOE CLUB
3619	ALOFT
3618	GREAT WOLF
3617	AMERICA'S BEST VALUE INN
3615	TRAVELODGE
3614	AMERICINN
3613	MICROTEL INNS & SUITES
3612	MOEVENPICK HOTELS
3609	GAYLORD PALMS
3608	GAYLORD OPRYLAND
3607	FONTAINEBLEAU RESORTS
3604	HILTON GARDEN INN
3603	NOAH'S HOTELS
3602	HUDSON HOTEL
3601	TRADEWINDS RESORTS
3600	SADDLEBROOK RESORT TAMPA
3599	PANNONIA HOTELS
3598	REGENT INTERNATIONAL HOTELS
3597	RIVERSIDE RESORT HOTEL AND CASINO
3596	WYNN LAS VEGAS
3595	HOSPITALITY INNS
3594	ARIZONA BILTMORE
3593	CUNARD HOTELS
3592	OMNI HOTELS
3591	SONESTA HOTELS
3590	FAIRMONT HOTELS
3589	DORAL GOLF RESORT
3588	HELMSLEY HOTELS
3587	DORAL HOTELS
3586	SOKOS HOTELS
3585	HUNGAR HOTELS
3584	PRINCESS HOTELS INTERNATIONAL
3583	RADISSON BLU
3582	CALIFORNIA HOTEL AND CASINO
3581	DELTA HOTEL
3580	HOTEL DEL CORONADO
3579	HOTEL MERCURE
3578	FRANKENMUTH BAVARIAN
3577	MANDARIN ORIENTAL HOTEL
3576	LA QUINTA RESORT
3575	VAGABOND HOTELS
3574	VENTURE INNS
3573	SANDMAN HOTELS
3572	MIYAKO HOTELS
3571	GRAND WAILEA RESORT
3570	FORUM HOTELS
3569	TRIBECA GRAND HOTEL
3568	LADBROKE HOTELS
3567	SOHO GRAND HOTEL
3566	GARDEN PLACE HOTEL
3565	RELAX INNS
3564	SAM'S TOWN HOTEL AND CASINO
3563	JOURNEY'S END MOTELS
3562	COMFORT INNS
3561	GOLDEN NUGGET
3560	ALADDIN RESORT AND CASINO
3559	CANDLEWOOD SUITES
3558	JOLLY HOTELS
3557	MANHATTAN EAST SUITE HOTELS
3556	BARTON CREEK RESORT
3555	TREASURE ISLAND HOTEL AND CASINO
3554	PINEHURST RESORT
3553	PARK INNS INTERNATIONAL
3552	COAST HOTELS
3551	MIRAGE HOTEL AND CASINO
3550	REGAL 8 INNS
3549	AUBERGE DES GOVERNEURS
3548	HOTELES MELIA
3546	HOTEL SIERRA
3545	SHANGRI-LA INTERNATIONAL
3544	CIGA HOTELS
3543	FOUR SEASONS HOTELS
3542	ROYAL HOTELS
3541	HOTEL OKURA
3540	IBEROTEL HOTELS
3539	SUMMERFIELD SUITES HOTELS
3538	CONCORDE HOTELS
3537	ANA HOTEL
3536	AMFAC HOTELS
3535	HILTON INTERNATIONALS
3534	SOUTHERN PACIFIC HOTELS
3533	HOTEL IBIS
3532	ROYAL KONA RESORT
3531	KAUAI COCONUT BEACH RESORT
3530	RENAISSANCE HOTELS
3529	CP HOTELS
3528	RED LION INNS
3527	DOWNTOWNER-PASSPORT HOTEL
3526	PRINCE HOTELS
3525	DUNFEY HOTELS
3524	WELCOMGROUP HOTELS
3523	PENINSULA HOTEL
3522	TOKYO HOTEL
3521	ROYAL LAHAINA RESORTS
3520	MERIDIEN HOTELS
3519	PULLMAN INTERNATIONAL HOTELS
3518	SOL HOTELS
3517	AMERICANA HOTELS
3516	LA QUINTA INN AND SUITES
3515	RODEWAY INNS
3514	AMERISUITES
3513	WESTIN
3512	INTER-CONTINENTAL HOTELS
3511	ARABELLA HOTELS
3510	DAYS INNS
3509	MARRIOTT
3508	QUALITY INNS
3507	FRIENDSHIP INNS
3506	GOLDEN TULIP HOTELS
3505	FORTE HOTELS
3504	HILTON HOTELS
3503	SHERATON
3502	BEST WESTERN HOTELS
3501	HOLIDAY INNS
3441	ADVANTAGE RENT-A-CAR
3439	MILLEVILLE RENT-A-CAR
3438	INTERENT RENT-A-CAR
3437	CITE RENT-A-CAR
3436	AUTOHANSA RENT-A-CAR
3435	VALUE RENT-A-CAR
3434	USA RENT-A-CAR
3433	UGLY DUCKLING RENT-A-CAR
3432	RESERVE RENT-A-CAR
3431	REPLACEMENT RENT-A-CAR
3430	MAJOR RENT-A-CAR
3429	INSURANCE RENT-A-CAR
3428	CAREY RENT-A-CAR
3427	AVON RENT-A-CAR
3425	AUTOMATE RENT-A-CAR
3423	AVCAR RENT-A-CAR
3421	ALLSTATE RENT-A-CAR
3420	ANSA INTL RENT-A-CAR
3414	GODFREY NATL RENT-A-CAR
3412	A-1 RENT-A-CAR
3409	GENERAL RENT-A-CAR
3405	ENTERPRISE RENT-A-CAR
3400	AUTO HOST CAR RENTALS
3398	ECONO-CAR RENT-A-CAR
3396	TILDEN RENT-A-CAR
3395	THRIFTY CAR RENTAL
3394	KEMWELL GROUP RENT-A-CAR
3393	NATIONAL CAR RENTAL
3391	EUROPE BY CAR
3390	DOLLAR RENT-A-CAR
3389	AVIS RENT-A-CAR
3388	MERCHANTS RENT-A-CAR
3387	ALAMO RENT-A-CAR
3386	SHOWCASE RENTAL CARS
3385	TROPICAL RENT-A-CAR
3381	EUROP CAR
3380	TRIANGLE RENT-A-CAR
3376	AJAX RENT-A-CAR
3374	ACCENT RENT-A-CAR
3370	RENT-A-WRECK
3368	HOLIDAY RENT-A-CAR
3366	BUDGET RENT-A-CAR
3364	AGENCY RENT-A-CAR
3362	ALTRA AUTO RENTAL
3361	AIRWAYS RENT-A-CAR
3360	SNAPPY CAR RENTAL
3359	PAYLESS CAR RENTAL
3357	HERTZ
3355	SIXT CAR RENTAL
3354	ACTION AUTO RENTAL
3353	BROOKS RENT-A-CAR
3352	AMERICAN INTL RENT-A-CAR
3351	AFFILIATED AUTO RENTAL
3302	FLYBE LTDFLYBEAIR
3301	WIZZ AIRWIZZ AIR
3300	AZUL AIRAZUL AIR
3299	WIDEROE'S FLYVESELSKAPWIDEROES
3298	AIR MAURITIUSAIRMAURITIUS
3297	TAROM ROMANIAN AIR TRANSPORTTAROM AIR
3296	AIR BERLINAIR BERLIN
3295	KENYA AIRWAYSKENYA AIR
3294	ETHIOPIAN AIRLINESETHIOPIAN AIR
3293	ECUATORIANAECUATORIANA
3292	CYPRUS AIRWAYSCYPRUS AIR
3287	AERO COACH AVIATIONAEROCOACH AV
3286	AEROLINEAS NICARAGUENSISAERONICARAG
3285	AEROPERUAEROPERU
3284	AERO VIRGIN ISLANDSAERVIRGINIS
3282	AIR DJIBOUTIAIR DJIBOUTI
3280	AIR JAMAICAAIR JAMAICA
3267	AIR PANAMAAIR PANAMA
3266	AIR SEYCHELLESAIR SEYCH
3263	AERO SERVICO CARABOBOASC AIRLINE
3262	RENO AIR, INC.RENO AIR
3261	AIR CHINAAIR CHINA
3260	SPIRIT AIRLINESSPIRIT AIR
3259	AMERICAN TRANS AIRATA AIR
3256	ALASKA AIRLINESALASKA AIR
3254	US AIR SHUTTLEUSAIRSHUTL
3252	ALMALM AIRLINE
3251	ALOHA AIRLINESALOHA AIR
3248	TAM AIRLINESTAM AIR
3247	GOL AIRLINESGOL AIR
3246	RYANAIRRYANAIR
3245	EASYJET AIRLINESEASYJET AIR
3243	AUSTRIAN AIR SERVICEAUST AIRSERV
3242	AVENSAAVENSA AIR
3241	AVIATECA (GUATEMALA)AVIATECA AIR
3240	BAHAMASAIRBAHAMASAIR
3239	BAR HARBOR AIRLINESBARHARBORAIR
3238	BEMIDJI AIRLINESBEMIDJI AIR
3236	AIR ARABIA AIRLINEAIR ARABIA
3235	BROCKWAY AIRBROCKWAY AIR
3234	CARIBBEAN AIRLINESCARIBBEANAIR
3233	CAPITOL AIRCAPITOL AIR
3231	SAHSA – SERVICIO AEREO DE HONDURASSAHSA AIR
3229	SAETA – SOCIAEDAD ECUATORIANOS DE TRANSPORTES AEREOSSAETA AIR
3228	CAYMAN AIRWAYSCAYMANAIR
3226	SKYWAYS AIRSKYWAYS AIR
3223	COMAIRCOMAIR
3222	COMMAND AIRWAYSCOMMAND AIR
3221	TRANSPORTES AEROS MILITARES ECUATORIANOSTAME AIRLINE
3220	COMPANIA FAUCETTCOMP FAU AIR
3219	COPACOPA AIR
3218	CROWN AIRCROWN AIR
3217	CSACSA AIRLINE
3216	CUMBERLAND AIRLINESCUMBERLNDAIR
3215	DAN AIR SERVICESDANAIRSERV
3213	BRAATHENS REGIONAL AIRLINESBRAATHENS REGIONAL AIR
3212	DOMINICANADOMINICA AIR
3211	NORWEGIAN AIR SHUTTLENORWEGIANAIR
3206	CHINA EASTERN AIRLINESCHINEASTAIR
3204	FREEDOM AIRFREEDOM AIR
3203	GOLDEN PACIFIC AIRGOLDPAC AIR
3200	GUYANA AIRWAYSGUYANA AIR
3197	HAVASU AIRLINESHAVASU AIR
3196	HAWAIIAN AIRHAWAIIAN AIR
3193	INDIAN AIRLINESINDIAN AIR
3191	ISLAND AIRLINESISLAND AIR
3190	JUGOSLAV AIRJUGOSLAV AIR
3188	VIRGIN EXPRESSVIRGINEXPAIR
3187	LACSA (COSTA RICA)LACSA AIR
3186	LAP (PARAGUAY)LAP AIR
3185	LAV (VENEZUELA)LAV AIR
3184	LIATLIAT AIRLINE
3183	OMAN AVIATION SERVICESOMANAIR
3182	LOT (POLAND)LOT AIR
3181	MALEVMALEV AIR
3180	WESTJET AIRLINESWESTJETAIR
3178	MESA AIRMESA AIR
3177	AIRTRAN AIRWAYSAIRTRANAIR
3176	METROFLIGHT AIRLINESMETROFLT AIR
3175	MIDDLE EAST AIRMIDEAST AIR
3174	JETBLUE AIRWAYSJETBLUE
3172	NATIONAIRNATIONAIR
3171	CANADIAN AIRLINES INTERNATIONALCANADIAN AIR
3170	MOUNT COOKMT COOK AIR
3167	AEROCONTINENTEAEROCONTINEN
3165	NEW YORK HELICOPTERNY HELI
3164	NORONTAIRNORONTAIR
3161	ALL NIPPON AIRWAYSANA AIR
3159	PBAPBA AIRLINE
3156	GO FLY LTDGOFLY
3154	PRINCEVILLEPRINCVLLEAIR
3151	AIR ZAIREAIR ZAIRE
3148	AIR LITTORAL SAAIRLITTORAL
3146	LUXAIRLUXAIR
3145	SAN JUAN AIRLINESSAN JUAN AIR
3144	VIRGIN ATLANTICVIRGINATLAIR
3143	SCENIC AIRLINESSCENIC AIR
3138	SIMMONS AIRLINESSIMMONS AIR
3137	SINGLETONSINGLETONAIR
3136	QATAR AIRWAYSQATAR AIR
3135	SUDAN AIRWAYSSUDAN AIR
3133	SUNBELT AIRLINESSUNBELT AIR
3132	FRONTIER AIRLINESFRONTIER AIR
3131	VLM AIRLINESVLM AIR
3130	SUNWORLD INTERNATIONALSUNWORLD AIR
3129	SURINAM AIRWAYSSURINAM AIR
3127	TACA INTERNATIONALTACAINTL AIR
3126	TALAIRTALAIR
3125	TANTAN AIR
3118	VALLEY AIRLINESVALLEY AIR
3117	VIASAVIASA
3115	TOWER AIRTOWERAIR
3112	WINDWARD ISLANDWINDWRDISAIR
3111	BRITISH MIDLANDBRMIDLANDAIR
3110	WINGS AIRWAYSWINGS AIR
3106	BRAATHENS S.A.F.E. (NORWAY)BRAATHENS
3103	GARUDA (INDONESIA)GARUDA AIR
3102	IBERIAIBERIA AIR
3100	MALAYSIAN AIRLINE SYSTEMMALAY AIR
3099	CATHAY PACIFICCATHAYPACAIR
3098	ASIANA AIRLINESASIANA AIR
3097	SPANAIRSPANAIR
3096	AIR ZIMBABWEAIR ZIMBABWE
3094	ZAMBIA AIRWAYSZAMBIA AIR
3090	UNI AIRWAYS CORPORATIONUNIAIR
3089	TRANSAEROTRANSAERO
3088	CROATIA AIRLINESCROATIA AIR
3087	METRO AIRLINESMETRO AIR
3086	CARNIVAL AIRLINESCARNIVAL AIR
3085	MIDWEST EXPRESS AIRLINESMIDWEST EXP
3084	EVA AIRWAYSEVA AIR
3083	AIR AFRIQUEAIR AFRIQUE
3082	KOREAN AIRLINESKOREAN AIR
3079	JETSTAR AIRWAYSJETSTAR AIR
3078	CHINA AIRLINESCHINA AIR
3077	THAI AIRWAYSTHAI AIRWAYS
3076	AEROMEXICOAEROMEXICO
3075	SINGAPORE AIRLINESSINGAPOREAIR
3072	CEBU PACIFIC AIRLINESCEBU PAC
3071	AIR BRITISH COLUMBIAAIR BC
3069	SUN COUNTRY AIRLINESSUNCNTRYAIR
3068	AIR ASTANAAIR ASTANA
3067	VANGUARD AIRLINESVANGUARD AIR
3066	SOUTHWESTSOUTHWESTAIR
3065	AIRINTERAIRINTER
3064	ADRIA AIRWAYSADRIA AIR
3063	US AIRWAYSUSAIRWAYS
3062	HAPAG-LLOYD EXPRESS AIRLINESHLX AIR
3061	CONTINENTALCONTINENTAL
3060	NORTHWESTNWA AIR
3059	DBA AIRLINESDBA AIR
3058	DELTADELTA AIR
3057	VIRGIN AMERICAVIR AMER
3056	JET AIRWAYSJET AIR
3055	LAB (BOLIVIA)LAB AIR
3054	LADECO (CHILE)LADECO AIR
3053	AVIACO (SPAIN)AVIACO AIR
3052	LAN AIRLINESLAN AIR
3051	AUSTRIAN AIRLINESAUSTRIAN AIR
3050	ICELANDAIRICELANDAIR
3049	TUNIS AIRTUNIS AIR
3048	ROYAL AIR MAROCAIR MAROC
3047	TURKISH AIRLINESTURKISH AIRLINES
3046	CRUZEIRO DO SUL (BRAZIL)CRUZEIRO AIR
3045	NIGERIA AIRWAYSNIGERIA AIR
3044	AIR LANKAAIR LANKA
3043	AER LINGUSAER LINGUS
3042	FINNAIRFINNAIR
3041	BALKAN-BULGARIAN AIRLINESBALKAN AIR
3040	GULF AIR (BAHRAIN)GULF AIR
3039	AVIANCAAVIANCA
3038	KUWAIT AIRWAYSKUWAIT AIR
3037	EGYPTAIREGYPTAIR
3036	VASP (BRAZIL)VASP AIR
3035	TAP (PORTUGAL)TAP AIR
3034	ETIHAD AIRWAYSETIHADAIR
3033	ANSETT AIRLINESANSETT AIR
3032	EL ALEL AL
3031	OLYMPIC AIRWAYSOLYMPIC AIR
3030	AEROLINEAS ARGENTINASAERO ARGENT
3029	SN BRUSSELS AIRLINESSNBRSSLSAIR
3028	AIR MALTAAIR MALTA
3027	UTA/INTERAIRUTA AIRLINE
3026	EMIRATES AIRLINESEMIRATES
3025	AIR NEW ZEALANDAIR NZ
3024	PAKISTAN INTERNATIONALPAKISTAN AIR
3023	MEXICANAMEXICANA
3022	PHILIPPINE AIRLINESPAL AIR
3021	AIR ALGERIEAIR ALGERIE
3020	AIR-INDIAAIR-INDIA
3018	VARIG (BRAZIL)VARIG
3017	SOUTH AFRICAN AIRWAYSSAA AIRWAYS
3016	SASSAS
3015	SWISS INTERNATIONAL AIRLINESSWISSINTAIR
3014	SAUDI ARABIAN AIRLINESSAUDIA AIR
3013	ALITALIAALITALIA
3012	QANTASQANTAS AIR
3011	AEROFLOTAEROFLOT
3010	KLM (ROYAL DUTCH AIRLINES)KLM AIRLINE
3009	AIR CANADAAIR CANADA
3008	LUFTHANSALUFTHANSA
3007	AIR FRANCEAIR FRANCE
3006	JAPAN AIRLINESJAL AIRLINE
3005	BRITISH AIRWAYBRITISH AWYS
3004	DRAGON AIRLINESDRAGONAIR
3003	EUROFLY AIRLINESEUROFLY AIR
3002	PAN AMERICANPAN AM AIR
3001	AMERICAN AIRLINES AMERICAN AIR
3000	UNITED AIRLINESUNITED AIR
2842	Specialty Cleaning, Polishing and Sanitation Preparations
2791	Typesetting, Plate Making and Related Services
2741	Miscellaneous Publishing and Printing
1799	Special Trade Contractors (Not Elsewhere Classified)
1771	Concrete Work Contractors
1761	Roofing, Siding, and Sheet Metal Work Contractors
1750	Carpentry Contractors
1740	Masonry, Stonework, Tile Setting, Plastering and Insulation Contractors
1731	Electrical Contractors
1711	Heating, Plumbing, and Air Conditioning Contractors
1520	General Contractors – Residential and Commercial
0780	Landscaping and Horticultural Services
0763	Agricultural Co-operatives
0742	Veterinary Services
0742	Veterinary Services
0742	Veterinary Services
0763	Agricultural Co-operatives
0742	Veterinary Services
3003	EUROFLY AIRLINESEUROFLY AIR
3002	PAN AMERICANPAN AM AIR
3001	AMERICAN AIRLINES AMERICAN AIR
3000	UNITED AIRLINESUNITED AIR
2842	Specialty Cleaning, Polishing and Sanitation Preparations
2791	Typesetting, Plate Making and Related Services
2741	Miscellaneous Publishing and Printing
1799	Special Trade Contractors (Not Elsewhere Classified)
1771	Concrete Work Contractors
1761	Roofing, Siding, and Sheet Metal Work Contractors
1750	Carpentry Contractors
1740	Masonry, Stonework, Tile Setting, Plastering and Insulation Contractors
1731	Electrical Contractors
1711	Heating, Plumbing, and Air Conditioning Contractors
1520	General Contractors – Residential and Commercial
0780	Landscaping and Horticultural Services
0763	Agricultural Co-operatives
0742	Veterinary Services
3003	EUROFLY AIRLINESEUROFLY AIR
3002	PAN AMERICANPAN AM AIR
3001	AMERICAN AIRLINES AMERICAN AIR
3000	UNITED AIRLINESUNITED AIR
2842	Specialty Cleaning, Polishing and Sanitation Preparations
2791	Typesetting, Plate Making and Related Services
2741	Miscellaneous Publishing and Printing
1799	Special Trade Contractors (Not Elsewhere Classified)
1771	Concrete Work Contractors
1761	Roofing, Siding, and Sheet Metal Work Contractors
1750	Carpentry Contractors
1740	Masonry, Stonework, Tile Setting, Plastering and Insulation Contractors
1731	Electrical Contractors
1711	Heating, Plumbing, and Air Conditioning Contractors
1520	General Contractors – Residential and Commercial
0780	Landscaping and Horticultural Services
0763	Agricultural Co-operatives
0742	Veterinary Services

失败原因 (fail_code)

值	含义
1	用户资产余额不足
3	用户账户被风控
4	超出每月消费限额
5	MCC 限制商户消费
6	MCC 限制地区消费
7	超出单笔消费限额
8	重复消费授权
9	消费授权不存在
10	超出每日消费限额
11	超出单笔 ATM 取现限额
12	超出每日 ATM 取现限额
13	超出每月 ATM 取现限额
20	PIN验证失败
21	连续PIN错误超限
22	未设置PIN
100	渠道官方账户余额不足
101	平台其他错误
102	平台卡配置错误
103	平台其他错误
104	渠道授权失败
105	卡商余额不足
106	新增交易通知失败
107	更新交易通知失败
108	更新交易授权失败
109	新增 3DS 验证码通知失败
110	OCT
200	账户不存在
201	超出卡片限额
202	卡片限制（跨境/刷卡等）
203	卡号不存在
204	卡令牌不存在
205	卡片已挂失
206	卡片被盗
207	卡片已暂停
208	卡片未激活
209	卡片因欺诈被冻结
210	卡片永久锁定
211	卡片无效
212	卡令牌已暂停
213	卡令牌未激活
214	卡令牌已停用
215	卡令牌已过期
216	卡令牌缺少有效期
217	合约不存在
218	CBS服务不可用（超时）
219	重复交易
220	系统错误或维护中
221	欺诈交易被拒绝
222	余额不足
223	可用余额不足
224	原始交易不存在
225	交易类型不允许
226	卡商未知错误
227	VIAA限额超限
228	CVV2验证失败
229	CAVV验证失败（3DS）
230	Track 2 数据无效
231	加密验证失败

限制国家列表

国家码（alpha-2）	手机区号	国家手机名称
ht	509	海地（Haiti)
lb	961	黎巴嫩（Lebanon)
ml	223	马里（Mali)
ni	505	尼加拉瓜（Nicaragua)
bi	257	布隆迪（Burundi)
cf	236	中非共和国 (Central African Republic)
er	291	厄立特里亚（Eritrea)
gw	245	几内亚比绍（Guinea-Bissau)
iq	964	伊拉克（Iraq)
ly	218	利比亚（Libya)
mm	95	缅甸（Myanmar)
rw	250	卢旺达（Rwanda)
sl	232	塞拉利昂（Sierra Leone)
bf	226	布基纳法索（Burkina Faso)
cg	242	刚果（Congo)
cm	237	喀麦隆（Cameroon)
mz	258	莫桑比克（Mozambique)
tz	255	坦桑尼亚（Tanzania)
ug	256	乌干达（Uganda)
lr	231	利比里亚（Liberia)
jm	1-876	牙买加（Jamaica)
pw	680	帕劳（Palau)
za	27	南非（South Africa)
ua	380	乌克兰（Ukraine)
ru	7	俄罗斯（Russia
ve	58	委内瑞拉（Venezuela)
af	93	阿富汗（Afghanistan)
by	375	白俄罗斯（Belarus)
cd	243	刚果民主共和国（Congo (DRC))
cu	53	古巴（Cuba)
ir	98	伊朗（Iran)
kp	850	朝鲜（North Korea)
so	252	索马里（Somalia)
ss	211	南苏丹（South Sudan)
sd	249	苏丹（Sudan)
sy	963	叙利亚（Syria)
ye	967	也门（Yemen)
zw	263	津巴布韦（Zimbabwe)