创建卡

service: createCard

bizContent 请求参数

名称	类型	必填	描述	备注
cardCurrencyCode	String	N	卡币种	默认与结算币种相同。 ISO 4217字母代码，3位字符。
settlementCurrencyCode	String	Y	结算币种	ISO 4217字母代码，3位字符。
activeDate	String	Y	生效日期	格式 yyyy-MM-dd。
inactiveDate	String	Y	失效日期	格式 yyyy-MM-dd。
cardLimit	Number	Y	额度	小数，对应卡币种。
minAuthAmount	Number	Y	单次授权金额下限	小数，对应卡币种。 （预付费卡，此字段不生效）
maxAuthAmount	Number	Y	单次授权金额上限	小数，对应卡币种。 （预付费卡，此字段不生效）
cardProductCode	String	Y	卡产品	枚举值，详见卡分类层次。
cardType	String	Y	卡类型	枚举值，详见卡分类层次。
cardLabel	String	Y	卡组织	枚举值，详见卡分类层次。
reference	String	N	用户自定义字段

卡分类层次

名称	描述	备注
cardProductCode	卡产品	枚举值，C01；C02；C03；C04；C05
cardType	卡类型	枚举值，详见卡分类层。
cardLabel	卡组织	枚举值，MasterCard；VISA

卡分类层次详情

卡产品	卡账户	发卡地区	卡类型	卡组织
C01	贷记	中国香港	MCO； GWTTP； GWTTP-MBA； GWTTP-MBG； GWTTP-MBH； GWTTP-MBI； GWTTP-MBJ	MasterCard
C01	贷记	美国	USDVCC	MasterCard； VISA
C02	借记	中国香港	MCO GWTTP； GWTTP-MBA； GWTTP-MBG； GWTTP-MBH； GWTTP-MBI； GWTTP-MBJ	MasterCard
C02	借记	新加坡	TAE； B2B	VISA
C03	预付费	美国	USDVCC	MasterCard； VISA
C04	贷记	新加坡	TAE；B2B	VISA
C05	借记（换汇）	中国香港	MCO GWTTP； GWTTP-MBA； GWTTP-MBG； GWTTP-MBH； GWTTP-MBI； GWTTP-MBJ	MasterCard
C05	借记（换汇）	新加坡	TAE； B2B	VISA

bizContent 请求体示例

{
  "cardCurrencyCode": "USD",
  "settlementCurrencyCode": "USD",
  "activeDate": "2022-01-01",
  "inactiveDate": "2024-06-01",
  "cardLimit": 1000.12,
  "minAuthAmount": 3.45,
  "maxAuthAmount": 500.67,
  "cardProductCode": "C02",
  "cardType": "GWTTP",
  "cardLabel": "MasterCard",
  "reference": "anything"
}

bizContent 响应参数

名称	类型	描述	备注
returnCode	String	结果码	枚举值，6位数字，详见结果码。 （非000000表示请求处理失败）
errorMessage	String	结果码描述	详见结果码。
cardLogId	String	卡ID	平台专用卡标识。
cardNum	String	卡号	16位卡号。
cardExpirationDate	String	有效期	格式 yyMM。
cvv2	String	卡CVV2	安全码。
cardType	String	卡品牌
cardLabel	String	卡组织

结果码

重要：具体业务操作结果以 returnCode 为准

returnCode	errorMessage	备注
000000	Success	成功。
100000	Input parameter is incorrect（不固定）	请求参数错误。
100001	Reduplicative requestid	requestId重复。
200002	Both MCC, MCC groups and [acquirerId,merchantId] are all empty	supportedMccGroup与（supportedMid或supportedAccquirerId）都为空。
200003	Customer info not find	客户信息不存在。
200007	Global parameter not find	客户全局配置不存在。
200008	InactiveDate must be greater than activeDate	不可交易日必须晚于可交易日。
200013	Not find the mapping between the cardCurrency and settlementCurrency	结算账户不存在。
200014	AcquirerId/mid must not be empty	收单行ID与商户ID必须同时存在。
200022	Not find active pan number config	卡号生成失败。
200029	Card exists pending request	其他操作执行中。
200036	card bin not support	卡品牌不支持。
200037	InactiveDate must submit	卡不可交易日生成失败。
200038	cardCloseUsage not be null	cardCloseUsage格式不正确。
200040	Invalid global parameter (indate)	卡有效期配置不存在。
200043	mcc group is empty	supportedMccGroup为空。
200044	mcc group all is not supported	supportedMccGroup不可为all。
200048	（不固定）	发卡行处理失败。
200060	（不固定）	发卡行请求参数错误。
300004	mcc link channel group is empty	发卡行MCC组为空。
300005	Trading is risky	高风险请求。
9XXXXX	（不固定）	系统错误。

bizContent 响应体示例

{
  "returnCode": "000000",
  "errorMessage": "Success",
  "cardLogId": "9448b6a7b3bcb22f99c1bedd246aba092c7932fd5e7f3042607bf58bc7cc3d83",
  "cardNum": "5229811460053354",
  "cardExpirationDate": "2406",
  "cvv2": "123",
  "cardType": "GWTTP",
  "cardLabel": "MasterCard"
}