API Documentation
NeoX documents
NeoX documents
  • Introduction
  • NeoX App
    • E-Wallet
    • eKYC
    • Functionality
  • Payment Gateway
    • Payment Methods
    • Integrations
      • Hosted Checkout
        • Plugin/Extenstion
        • iOS SDK
        • Android SDK
        • React Native SDK
        • Web SDK
        • APIs
      • Direct API
        • Tokenization
      • Refund
        • APIs
        • IPN
    • Transaction Management
      • Query DR
      • Cancel
      • IPN
      • Error Codes
      • Refund on portal
    • Reconciliation
    • Settlement
  • Disbursement
    • Integration
      • Introduction
      • How To Register
      • Security Method
      • Generate token API
      • Get merchant profile API
      • Request disbursement API
      • Get disbursement transaction API
      • Get exchange rate API
      • Inquiry bank account API
      • Currency conversion API
      • Event Notification
      • Response Data Structure
      • Error codes
    • Disbursement Account
    • Disbursement request
    • Transaction Management
      • Query Request/Transaction
      • Webhook
      • Error Codes
    • Reconciliation
  • Collections
    • Integration
      • Introduction
      • How To Register
      • Security Method
      • API authenPlatform
      • API upload file
      • APIs for virtual accounts management
        • API create list of virtual accounts
        • API update KYC virtual account information
        • API update Virtual Account transaction data from merchant
        • API set active/inactive Virtual Account
        • API get list virtual accounts
        • API get detail virtual account
      • APIs for transactions management
        • API update transaction documents
        • API get list transactions
        • API get detail transaction
      • APIs for refund requests management
        • API create refund request
        • API get list refund requests
        • API get detail refund request
      • APIs for withdraw requests management
        • API get list withdraw banks
        • API create withdraw request
        • API get list withdraw requests
        • API get detail withdraw request
      • Event Notification
      • SFTP upload document file of collection transaction
      • Error Codes
    • Virtual Account Management
      • Virtual Account
      • Virtual Account Status
      • Webhook
    • Transaction Management
      • Webhook
    • Transaction Status Management
      • Webhook
    • Refund Request Management
      • Webhook
    • Withdraw Request Management
      • Webhook
    • Reconciliation
    • Settlement
  • Virtual Card
    • API authenPlatform
    • Error Codes
    • Virtual Card Policy Management
      • API Create Card Policy
      • API Get Detail Card Policy
      • API Get List Card Policies
      • API Set Active Card Policy
      • API Update Card Policy
    • Virtual Card Management
      • Virtual Card APIs
        • API Create Virtual Card
        • API Create List Virtual Cards
        • API Get List Virtual Cards
        • API Get Detail Virtual Card
        • API Get Virtual Card Sensitive Data
        • API Set Active Virtual Card
      • Webhook
      • Decrypting Card Data Algorithm
  • Merchant Portal
    • Onboarding
    • Payment Gateway
      • Reconciliation
      • Withdraw
    • Disbursement
      • Reports
    • Collections
      • Reports
      • Withdraw
Powered by GitBook
On this page
  • Request
  • Response
  • Example cURL
  • Notes

Was this helpful?

  1. Virtual Card
  2. Virtual Card Policy Management

API Get Detail Card Policy

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

Description:

Request

Request Body Field Descriptions

Field Name
Type
Required
Description

N/A

N/A

N/A

GET request does not require a JSON body.

Request sample

// No request body required for this GET endpoint.

Response

Response Field Descriptions

Field Name
Type
Description

code

number

Response code

state

number

State of the response

data

object

Details of the 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": "DMD TEST CHINH SACH THE AO CHO MASTERCARD",
    "cardBrand": "visa",
    "expiryDate": "2028-12",
    "cardCurrency": "USD",
    "cardLimit": 30000000,
    "minTransAmount": 10000,
    "maxTransAmount": 20000000,
    "activeOnCreate": true,
    "autoCloseCard": false,
    "supportedMccGroup": [
      "9405",
      "8011"
    ],
    "isActive": true,
    "revision": 1,
    "createdAt": "2025-06-04T09:34:25.959Z",
    "createdBy": "sony@gmail.com",
    "updatedAt": "2025-06-04T09:34:25.959Z"
  },
  "message": "Successful",
  "neoResponseId": "ed849a63-1ffb-4032-b200-0548e53e2c08"
}

Example cURL

curl -X GET "https://{base_url_openapi}/v2/vc/virtual-card-policies/e424ae34-5c56-45c8-882e-98c4325981d3" \
  -H "Authorization: Bearer <YOUR_TOKEN>" \
  -H "accept-language: en"

Notes

  • Requires Bearer token in the Authorization header.

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

  • No request body required.

PreviousAPI Create Card PolicyNextAPI Get List Card Policies

Last updated 1 day ago

Was this helpful?