v1

latestOpenAPI 3.0.02026-07-242035712.0 MB
VCAS

Risk Call

Risk request is communicated by the VCAS platform to the partner for risk decisioning.

post/pws/risk/

Request body

IssuerIdstring required

Cardinal provided identifier for the partner. Length - Up to 24 Characters

ProcessorIdstring required

Cardinal provided identifier for the partner. Length - Up to 24 Characters

TransactionIdstring required

VCAS generated transaction reference id. Length - Up to 36 Characters. GUID format for EMV 3DS.

DSTransactionIdstring

Directory Server (DS) generated transaction reference id. GUID Format. EMV 3DS only.

MerchantChallengeIndicatorstring

Indicates whether the merchant requested a challenge.

3RIIndicatorstring

Indicates the type of 3RI request for EMV transactions.

NonPaymentAuthenticationIndicatorstring

Type of Non-Payment Authentication.

MessageVersionstring

Version of the message based on 3DS spec. Examples - 2.1.0, 2.2.0

RDXMessageVersionstring

Version of the RDX protocol being used.

MessageCategorystring

Message category: 01=PA, 02=NPA, 03-99 reserved.

RiskScorestring

Transaction risk score determined by VCAS (if available). 2 chars.

RuleOutcomestring

VCAS rule evaluation result: SUCCESS, FAIL, CHALLENGE, REJECTED, ERROR.

CardBrandNamestring

Card brand name.

Response

Successful Response

IssuerIdstring required

Echoed from Request. Length - Up to 24 Characters

ProcessorIdstring required

Echoed from Request. Length - Up to 24 Characters

Status'SUCCESS' | 'FAILURE' | 'RETRY' | 'PENDING' | 'BLOCKED' | 'STEPUP' | 'ERROR' | 'ATTEMPTS' | 'FAILWITHFEEDBACK' | 'REJECTED' | 'FAIL' | 'CHALLENGE' | 'AUTHENTICATED' | 'SUCCESS' | 'FAIL' | 'FAILWITHFEEDBACK' | 'CHALLENGE' | 'REJECTED' | 'ERROR' required

Status of Risk Request. Possible values: SUCCESS, FAIL, FAILWITHFEEDBACK, CHALLENGE, REJECTED, ERROR.

TransactionIdstring required

Echoed from Request. Length - Up to 36 Characters

TransStatusReasonstring

Provides information on why the Transaction Status field has the specified value. 2 chars.

Languagestring

Language for cardholder prompts (e.g., en, en-US). Up to 50 chars.

RiskIndicatorstring

Used in AV creation for EMV 3DS. Up to 3 chars (hex).

RiskScorestring

Client-determined risk score (00-99). 2 chars.