API Update Card Policy

Endpoint: PUT /v2/vc/virtual-card-policies/{requestId}

Description:

Update an existing virtual card policy with new parameters such as name, card brand, currency, limits, and supported MCC groups.


Request

Request Body Field Descriptions (JSON)

Field Name
Type
Required
Description

name

string

No

Name of the policy

cardBrand

string

No

Card brand ("visa", "mastercard")

cardCurrency

integer

No

Card currency (Support: "USD", "EUR", "GBP", "SGD", "HKD", "VND"). Default: USD

cardLimit

integer

No

Maximum card limit (in currency)

expiryDate

string

No

Card expiry date in format YYYY-MM

minTransAmount

integer

No

Minimum transaction amount (in currency)

maxTransAmount

integer

No

Maximum transaction amount (in currency)

activeOnCreate

boolean

No

Whether the card is active upon creation. Default: false

autoCloseCard

boolean

No

Whether the card should auto-close. Default: false

supportedMccGroup

string[]

No

List of supported Merchant Category Codes (MCC)

Request sample

{
  "name": "Synchronised reciprocal open architecture",
  "cardBrand": "visa",
  "cardCurrency": "USD",
  "cardLimit": 30000,
  "minTransAmount": 10,
  "maxTransAmount": 2000,
  "activeOnCreate": true,
  "autoCloseCard": false,
  "expiryDate": "2028-12",
  "supportedMccGroup": [
    "9405",
    "8011"
  ]
}

Response

Response Field Descriptions

Field Name
Type
Description

code

number

Response code

state

number

State of the response

data

object

Details of the updated virtual card policy

message

string

Response message

neoResponseId

string

Unique Neo response identifier

data object fields:

Field Name
Type
Description

requestId

string

Unique request identifier

merchantCode

string

Merchant code

name

string

Name of the policy

cardBrand

string

Card brand (e.g., visa)

expiryDate

string

Expiry date (YYYY-MM)

cardCurrency

string

Card currency

cardLimit

number

Card limit (in currency)

minTransAmount

number

Minimum transaction amount (in currency)

maxTransAmount

number

Maximum transaction amount (in currency)

activeOnCreate

boolean

Whether active on creation

autoCloseCard

boolean

Whether card auto closes

supportedMccGroup

array

Supported MCC groups

isActive

boolean

Whether the policy is active

revision

number

Revision number

createdAt

string

Creation timestamp (ISO 8601)

createdBy

string

Creator's email

updatedAt

string

Last update timestamp (ISO 8601)

Response sample

{
  "code": 1,
  "state": 2,
  "data": {
    "requestId": "e424ae34-5c56-45c8-882e-98c4325981d3",
    "merchantCode": "COLRLC",
    "name": "Synchronised reciprocal open architecture",
    "cardBrand": "visa",
    "cardCurrency": "USD",
    "cardLimit": 30000000,
    "expiryDate": "2028-12",
    "minTransAmount": 10000,
    "maxTransAmount": 20000000,
    "activeOnCreate": true,
    "autoCloseCard": false,
    "supportedMccGroup": [
      "9405",
      "8011"
    ],
    "isActive": true,
    "revision": 2,
    "createdAt": "2025-06-04T09:34:25.959Z",
    "createdBy": "[email protected]",
    "updatedAt": "2025-06-05T01:52:37.480Z"
  },
  "message": "Successful",
  "neoResponseId": "269524e2-5050-4b84-bb7d-f7f85c4c5a52"
}

Example cURL

curl -X PUT "https://{base_url_openapi}/v2/vc/virtual-card-policies/{requestId}" \
  -H "Authorization: Bearer <YOUR_TOKEN>" \
  -H "Content-Type: application/json" \
  -H "accept-language: vi" \
  -d '{
    "name": "Synchronised reciprocal open architecture",
    "cardBrand": "visa",
    "cardCurrency": "USD",
    "cardLimit": 30000,
    "minTransAmount": 10,
    "maxTransAmount": 2000,
    "activeOnCreate": true,
    "autoCloseCard": false,
    "expiryDate": "2028-12",
    "supportedMccGroup": [
      "9405",
      "8011"
    ]
  }'

Notes

  • Requires Bearer token in the Authorization header.

  • The Accept-Language header can be used to specify the response language (Support: "vi", "en").

  • Replace {requestId} in the endpoint with the actual policy request ID.

  • Ensure the MCC codes are valid and supported by your system.

Last updated

Was this helpful?