Activate Physical Card

curl --request POST \
  --url https://sandbox-openplatform.keysecure.io/open-api/v1/card/active \
  --header 'Content-Type: application/json' \
  --header 'Api-Key: your_api_key' \
  --header 'Timestamp: 1716307200000' \
  --header 'Access-Token: your_access_token' \
  --data '{
    "cardholder_no": "U202605220001",
    "card_no": "C202605220001",
    "cvv": "Base64EncodedEncryptedCvv...",
    "card_last_no": "1234"
  }'

{
  "code": 0,
  "msg": "Success",
  "data": {"result": true}
}

POST

open-api

card

active

curl --request POST \
  --url https://sandbox-openplatform.keysecure.io/open-api/v1/card/active \
  --header 'Content-Type: application/json' \
  --header 'Api-Key: your_api_key' \
  --header 'Timestamp: 1716307200000' \
  --header 'Access-Token: your_access_token' \
  --data '{
    "cardholder_no": "U202605220001",
    "card_no": "C202605220001",
    "cvv": "Base64EncodedEncryptedCvv...",
    "card_last_no": "1234"
  }'

{
  "code": 0,
  "msg": "Success",
  "data": {"result": true}
}

Activates a physical card. The card status must be ToActivate; after successful activation, it becomes Activated. The cvv must be encrypted with AES/ECB/PKCS5Padding + Base64 before being passed in. Transmitting plaintext CVV in the request body is strictly prohibited.

Plaintext CVV must be 3 digits only.
card_last_no must match the last four digits of the card number recorded on the platform.
cardholder_no must belong to the cardholder associated with this card.
For encryption algorithm details, see the “Code Utilities” section.

Request Headers

string

required

apiKey (merchant credential, bound to IP whitelist)

string

required

Unix timestamp in milliseconds. The deviation from the server time must be within 60 seconds, and future timestamps are not accepted.

string

required

string

default:"application/json"

Fixed to application/json

Request Body

string

required

Cardholder order number.

string

required

Card order number.

string

required

Encrypted CVV (Base64 ciphertext).

string

required

Last four digits of card number.

Response Parameters

number

Response status code. 0 indicates success.

string

Response message.

object

Response data.

Show data

boolean

Activation result

curl --request POST \
  --url https://sandbox-openplatform.keysecure.io/open-api/v1/card/active \
  --header 'Content-Type: application/json' \
  --header 'Api-Key: your_api_key' \
  --header 'Timestamp: 1716307200000' \
  --header 'Access-Token: your_access_token' \
  --data '{
    "cardholder_no": "U202605220001",
    "card_no": "C202605220001",
    "cvv": "Base64EncodedEncryptedCvv...",
    "card_last_no": "1234"
  }'

{
  "code": 0,
  "msg": "Success",
  "data": {"result": true}
}

Getting Started

API Documentation

Appendix

Request Headers

Request Body

Response Parameters

​Request Headers

​Request Body

​Response Parameters

Request Headers

Request Body

Response Parameters