---
title: "Issuer’s endpoint to handle VCAs initiate action flow"
method: POST
path: "/issuer-vcas-initiateaction-endpoint"
tags: ["VCAS"]
---

# Issuer’s endpoint to handle VCAs initiate action flow

`POST /issuer-vcas-initiateaction-endpoint`

## Request

- Base URL: `https://sandbox.pismolabs.io/passport`
- URL: `https://sandbox.pismolabs.io/passport/issuer-vcas-initiateaction-endpoint`
- Auth: none declared

Informs the issuer about the initiate action flow in the VCAS process.

## Request body

- VCASInitiateActionRequest
  - `id` string, required: Pismo-generated unique authentication ID
  - `provider` 'VCAS', required: Third-party provider name
  - `type` 'INITIATE_ACTION_CALL', required: The type of operation to be performed.
  - `card` Card, required
    - `id` integer: Enrolled card ID
    - `mode_id` integer: Card mode ID
    - `type` 'PLASTIC' | 'VIRTUAL' | 'RECURRING' | 'TEMPORARY': Card type
    - `hash` string: Encrypted PAN using 2048 rsa key and base64 encoded. Pismo provides the encrypt/decrypt keys for this field.
    - `bin` string: Card BIN (Bank Identification Number)
    - `last_four_digits` string: Card last four PAN digits
  - `account` AccountV2, required
    - `id` integer: Account ID
    - `document_number` string: Cardholder government document number. This can be from any document that identifies the cardholder such as a Tax ID, State ID, or driver's license.
    - `phones` StructuredPhone[]
      - `area_code` string: Area code of the phone number
      - `country_code` string: Country code of the phone number
      - `number` string: Phone number without area code
      - `type` string: Type of phone number (e.g., mobile, commercial, residential)
    - `email` string: E-mail
  - `program` Program, required
    - `id` integer: Program ID
  - `customer` Customer, required
    - `id` integer: Pismo customer ID.
  - `raw_provider` RawProvider, required: All non-PCI information received from provider. Check provider documentation for details.

## Response `200`

OK

- VCASInitiateActionResponse
  - `raw_response` object: Raw response to VCAS InitiateAction request, according with VCAS documentation.

---

[API](https://skmtc.dev/pismo/apis/platform-authentication.md) - [All operations](https://skmtc.dev/pismo/apis/platform-authentication/llms.txt) - [OpenAPI document](https://skmtc.dev/pismo/apis/platform-authentication/revisions/935b62e16de4?raw)