跳到主要内容

概述​

创建虚拟卡，并对卡片设置交易限制。

创建您的卡片​

设置请求头组​

cURL -X POST /cards/create
-H 'Content-Type: application/json'
-H 'Authorization: {token}'

创建持卡人​

在创建卡片之前，您需要先创建持卡人，获取持卡人ID card_holder_id：

{
    "data": {
        "card_holder_id": 1955930998425718784
    }
}

获取账户卡类型​

通过账户卡类型列表获取program_value类型：

{
  "program_value": 01,
  "program_cn_name": "美金单币卡_USD",
  "program_en_name": "Oceanpayment Merchant USD_HOME"
}

设置您的卡交易限制​

  • 设置您的交易限制，其中交易限制的key为trade_risk_name，交易限制value值为trade_risk_value。
  • 设置多个限制：当您的卡交易限制有多个规则时，可以通过risk_list进行设置。
cURL -X POST /card-api/v1/cards/create
-H 'Content-Type: application/json'
-H 'Authorization: {token}'
-d '{
	"card_name": "78415632",
	"card_holder_id": "1814356660259814571",
	"card_desc": 100,
	"card_validity_time": "202805",
	"program_value": "01",
	"risk_list": [{
			"trade_risk_name": "purchase_count_1d",
			"trade_risk_value": "100"
		},
		{
			"trade_risk_name": "purchase_1d",
			"trade_risk_value": "10"
		},
		{
			"trade_risk_name": "allowed_countries",
			"trade_risk_value": "US,CN"
		}
	]

   }'
字段描述值
card_name卡片名称
card_holder_id持卡人ID
card_desc卡片描述
card_validity_time卡有效期
program_value账户卡类型
risk_list风险列表ARRAY
trade_risk_name
  • purchase_count_1d : 每日最大交易次数
  • purchase_count_7d : 每周最大交易次数
  • blocked_countries : 限制交易国家/地区
  • allowed_countries : 允许交易国家/地区
  • purchase_count_30d : 每月最大交易次数
  • purchase_1d : 每日最大交易限额
  • purchase_7d : 每周最大交易限额
  • purchase_30d : 每月最大交易限额
  • purchase_1y : 一年内最大交易金额
trade_risk_value
  • 当trade_risk_name为国家/地区blocked_countries或allowed_countries时，需要传ISO-3316三位国家代码
  • 其他类型为String，如金额，次数等

卡片创建成功​

创建卡片成功后，需要使用card_id来关联您的卡号信息。

{
    "code": "200",
    "msg": "操作成功",
    "trace_id": "6b9884b1583847c4a72b2b28525b2535",
    "data": {
        "card_id": 1954802358738284544,
        "card_number": "527375 **** 4392",
        "card_name": "",
        "card_status": "Activate",
        "create_time": "2025-08-11T15:09:35+08:00",
        "card_remark": null,
        "card_validity_time": "2027-08-01T00:00:00+08:00",
        "card_desc": "",
        "risk_list": [
            {
                "trade_risk_name": "purchase_1d",
                "trade_risk_value": "100"
            },
            {
                "trade_risk_name": "blocked_countries",
                "trade_risk_value": "US"
            }
        ],
        "program_value": 15,
        "program_cn_name": "美金悦享卡_OTA",
        "program_en_name": "USD Multi Card_OTA",
        "card_holder_id": 1950830536975781888,
        "create_status": 1,
        "create_resp_msg": null,
        "account_id": "1016X10034796020144"
    }
}
  1. 使用查询卡号与CVV获取您的卡号和CVV信息。
  2. 接下来使用查询卡详细信息来获取卡片有效期。