On This Page

Validating an Account Using a Transient Token: JSON Token ID

This section describes how to validate using a JSON token ID type of transient token submitted through the REST API. Follow these steps to request a bank account validation:

Create a request with the required and any optional REST API fields. Refer to the request and response examples, if needed.

Send the completed request to one of these endpoints:

Production:

POST api.visaacceptance.com/bavs/v1/account-validations

Test:

POST apitest.visaacceptance.com/bavs/v1/account-validations

Verify the response messages to make sure that the request succeeded. For more information, see the Transaction response codes.

Required Fields for Validating an Account Using a JSON Token ID

processingInformation.validationLevel: Set the value to
1
.
tokenInformation.jti: The value is the TMS transient token ID. A 64-hexadecimal character identifier representing capture payment credentials.

Optional Fields for Validating an Account

clientReferenceInformation.code: Set the value to any reference code that you choose to associate with the validation request. This code is returned in the response exactly as provided.

REST Example: Validating an Account Using a JSON Token ID

Request

{
    "clientReferenceInformation": {
        "code": "TC50171_3"
    },
    "processingInformation": {
        "validationLevel": 1
    },
    "tokenInformation": {
        "jti": "1D4LCS8NR0NKUBK31YG3A7Z2B1YCFU3KCJ81JTQM8WTSAH25JGAD698A2FD6372D"
    }
}

Response to a Successful Request

{ 
    "clientReferenceInformation": { 
        "code": "TC50171_3" 
    }, 
    "requestId": "string", 
    "submitTimeUtc": "string", 
    "bankAccountValidation": { 
        "rawValidationCode": integer, 
        "resultCode": integer, 
        "resultMessage": "string" 
    } 
}