v1

latestOpenAPI 3.1.0Copyright Pismo2026-07-247702,7523.1 MB

VCAS

Issuer’s endpoint to handle VCAs initiate action flow

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

post/issuer-vcas-initiateaction-endpoint

Request body

idstring 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.

raw_providerRawProvider required

All non-PCI information received from provider. Check provider documentation for details.

Example request

{
  "id": "ff77635e-1cd6-4fda-992d-5ceb71d75644",
  "provider": "VCAS",
  "type": "INITIATE_ACTION_CALL",
  "card": {
    "id": 869572,
    "mode_id": 102,
    "type": "PLASTIC",
    "hash": "WEPvOQuZvjfYEd0iBmr43bhWyOsylIsW95ebYrLD89App2iEq9IizP+8w73pxKQ4mI47EdhzYHF9RfXjrBOyug==",
    "bin": "885692",
    "last_four_digits": "0153"
  },
  "account": {
    "id": 10045896,
    "document_number": "00011122233",
    "phones": [
      {
        "area_code": "31",
        "country_code": "55",
        "number": "998675309",
        "type": "mobile"
      }
    ],
    "email": "ho_lee_smokes@gmail.com"
  },
  "program": {
    "id": 986
  },
  "customer": {
    "id": 867604
  },
  "raw_provider": {
    "ProcessorId": "5723ae630063ac1a9c3ab079",
    "IssuerId": "5723ae630063ac1a9c3ab654",
    "TransactionId": "00ec043e-40b5-4ce4-95c2-9e83b644f412",
    "DSTransactionId": "00ec043e-40b5-4ce4-95c2-9e83b644f258",
    "ThreeDSRequestorAuthenticationInd": "01",
    "StepupRequestId": "878f4751-4140-4881-9e4a-003e83524f22",
    "MessageVersion": "2.2.0",
    "RDXMessageVersion": "2.2.3",
    "MessageCategory": "01",
    "MerchantInfo": {
      "AcquirerId": "1337",
      "AcquirerCountryCode": "840",
      "MerchantId": "876543210",
      "MerchantName": "Ranier Expeditions",
      "MerchantURL": "https://www.requestor.com",
      "MerchantCategoryCode": "0123",
      "MerchantCountryCode": "840",
      "MerchantAppRedirectURL": "merchantScheme://appName?transID=b2385523-a66c-4907-ac3c-91848e8c0067"
    },
    "TransactionInfo": {
      "TransactionCurrency": "840",
      "Channel": "WEB"
    }
  }
}

Response

raw_responseobject

Raw response to VCAS InitiateAction request, according with VCAS documentation.

Example response

{
  "raw_response": {
    "ProcessorId": "7723ae630063ac1a9c3ab07976",
    "IssuerId": "5723ae630063ac1a9c3ab080",
    "TransactionId": "00ec043e-40b5-4ce4-95c2-9e83b644f412",
    "StepupRequestId": "00ec043e-40b5-4ce4-95c2-9e83b644f412",
    "StepupType": "OTP",
    "Language": "string",
    "Status": "SUCCESS",
    "TransStatusReason": "string",
    "RiskIndicator": "string",
    "Credentials": [
      {
        "Id": "d94fd3fd-bef1-49cb-88ab-a6841261cea9",
        "Type": "OTPEMAIL",
        "Text": "******@cardinalcommerce.com"
      }
    ],
    "Reason": {
      "ReasonCode": "string",
      "ReasonDescription": "string"
    },
    "Error": {
      "ReferenceNumber": "string",
      "ReasonDescription": "string",
      "Description": "string",
      "Message": "string"
    }
  }
}