Overview

Create a virtual card and configure transaction limits for the card.

Create Your Card

Set Request Headers

Resquest

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

Create a Cardholder

• If you already have a default cardholder, card_holder_id is optional.
• If you do not have a default cardholder, you must first create a cardholder to obtain the cardholder ID card_holder_id.

Responses

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

Retrieve Account Card Type

Retrieve the account card type list to obtain the program_value.

Responses

{
  "program_value": 01,
  "program_cn_name": "USD",
  "program_en_name": "Oceanpayment Merchant USD_HOME"
}

Configure Card Transaction Limits

• Define transaction limits for your card. Each rule consists of a trade_risk_name (limit key) and a corresponding trade_risk_value.
• Multiple limits: If multiple transaction rules are required, configure them using the risk_list array.

Resquest

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"
		}
	]

   }'

Parameter	Description	Type
card_name	Card name
card_holder_id	Cardholder ID
card_desc	Card description
card_validity_time	Card expiration time
program_value	Account card type
risk_list	Risk rules list	ARRAY
trade_risk_name	purchase_count_1d : Maximum number of transactions per day purchase_count_7d : Maximum number of transactions per week blocked_countries : Restricted countries/regions allowed_countries : Allowed countries/regions purchase_count_30d : Maximum number of transactions per month purchase_1d : Daily spending limit purchase_7d : Weekly spending limit purchase_30d : Monthly spending limit purchase_1y : Annual spending limit card_debit_lifetime : Card lifetime debit limit
trade_risk_value	For blocked_countries or allowed_countries, provide ISO 3166-1 alpha-3 country codes For other limit types, use String values (e.g., amount, transaction count)

• You can also retrieve configured transaction limits by querying card details.
• To modify existing limits, update the card settings.

Card Created Successfully

After the card is created, use the card_id to associate and retrieve the card number information.

Responses

{
    "code": "200",
    "msg": "Success",
    "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. Retrieve Card Number and CVV. Use the Retrieve Card Number and CVV API to obtain the card number and CVV.
2. Retrieve Card Details. Use the Retrieve Card Details API to obtain the card expiration date.