Citi API | Virtual Cards › Controllers

Unique ID of the API message sent. The messageId will be provided back in the corresponding response. The ID can be used for investigation and troubleshooting. The ID must be unique per integration.

programId?: string

Unique ID of the company record defined in the virtual cards system.

vcaIds?: Array<string>

Unique Identifier for each Virtual card request.

Response fields

vcaId?: string

A reference number that uniquely identifies the virtual card account.

vcaIds?: Array<string>

List of reference number that uniquely identifies the virtual card account.

Request example

curl https://$(catalog.host)/cards/vca/v2/cancel \
    -H 'Content-Type: application/json' \
    -H "Authorization: Bearer $ACCESS_TOKEN" \
    -d '{}'

200Example

{
  "vcaId": "vcaId",
  "vcaIds": [
    "string"
  ]
}

Create -> { allowed, amountLimit, authorizationHoldDays, 36 more... }

post/create

Create VCA for secure purchasing. It allows you to place a VCA creation request, with increased Transaction-Level Controls, limit card number use by MCC, amounts, dates and even specific suppliers

Modify -> { allowed, amountLimit, authorizationHoldDays, 34 more... }

post/modify

Modify VCA allows to update VCA request, to alter the Transaction-Level control data elements for flexible payments