On This Page

Validating an Account Using a Transient Token: JSON Web Token (JWT)

This section describes how to validate using a JWT 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 Web Token

processingInformation.validationLevel: Set the value to
1
.
tokenInformation.transientTokenJwt: The transient token encoded as JWT.

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 Web Token

Request

{
    "clientReferenceInformation": {
        "code": "TC50171_3"
    },
     "processingInformation": {
        "validationLevel": 1
        },
    "tokenInformation": {
        "transientTokenJwt": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJPbmxpbmUgSldUIEJ1aWxkZXIiLCJpYXQiOjE3NzA2NTY5OTYsImV4cCI6MTgwMjE5Mjk5NiwiYXVkIjoid3d3LmV4YW1wbGUuY29tIiwic3ViIjoianJvY2tldEBleGFtcGxlLmNvbSIsIkdpdmVuTmFtZSI6IkpvaG5ueSIsIlN1cm5hbWUiOiJSb2NrZXQiLCJFbWFpbCI6Impyb2NrZXRAZXhhbXBsZS5jb20iLCJSb2xlIjpbIk1hbmFnZXIiLCJQcm9qZWN0IEFkbWluaXN0cmF0b3IiXSwianRpIjoiMUQ0TENTOE5SME5LVUJLMzFZRzNBN1oyQjFZQ0ZVM0tDSjgxSlRRTThXVFNBSDI1SkdBRDY5OEEyRkQ2MzcyRCJ9.0cWjVLp1yacVm8ozW4yn2-LQklnQU7Ws44lvr16mpdI"
    }
}

Response to a Successful Request

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