Add Card Whitelists

POST

/v4/risk/card-whitelists/import

Asynchronously upload a .txt or .xlsx file to batch-import card whitelist entries:

Requires portal permission manage_card_whitelist (contact operations to enable)

Subject to the daily add limit (Asia/Shanghai calendar day); entries beyond the remaining quota are written up to that quota, and the rest are counted as rejected

Duplicate cards (already in the database or repeated in the file) are counted as duplicate and do not consume the daily limit

A successful upload returns only task_id; use the import-task query API for progress and summary

Maximum file size is 64MB

Signature (see the integration guide); only text fields such as note are signed — file is excluded. eg:
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:26

TrustPay Supported Billing Countries and US/Canada Regions

Query Card Whitelists