添加卡白名单

POST

/v4/risk/card-whitelists/import

异步上传 .txt 或 .xlsx 文件批量录入卡白名单。

需开通门户权限 manage_card_whitelist（联系运营配置）

受单日新增限额约束（Asia/Shanghai 自然日）；超限部分写入剩余配额，其余计入 rejected

重复卡号（库内已存在或文件内重复）计入 duplicate，不占用日限额

上传成功仅返回 task_id；导入进度与汇总请调用「导入任务查询」接口

单文件最大 64MB

签名（规则见接入说明；仅对文本字段如 note 验签，file 不参与），举例：
if note is empty sign = MD5("&secret=" + secret)
if not sign = MD5("note=vip batch&secret=" + secret)

Request

Header Params

Body Params multipart/form-dataRequired

Responses

🟢200Success

application/json

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.trustpay.money/v4/risk/card-whitelists/import' \
--header 'x-api-key: skdb5a0e623d457f34ec58a25e8be94b87a7f8604ae136446db8d32fb83a61d4e5' \
--form 'file=@""' \
--form 'note=""' \
--form 'sign=""'

Response Example

{
    "code": 880001,
    "message": "success",
    "data": {
        "task_id": "b4eae236-4385-4a9b-aeab-d4ae13055ecd"
    }
}

Modified at 2026-08-28 08:32:50

TrustPay API 与 Checkout 支持的国家和 US/CA 州省

导入任务查询