# Visa Account Updater

## Issuer Stop Advice API

Issuers can place stop advices in VAU to block specific merchants from receiving an automatic VAU credential update (e.g., following reported fraud) while still allowing their cardholder to transact with the merchant where appropriately authorized.

### Issuer Stop Advice API v1 - Latest

Issuer can place stop advice by providing following requested information

#### Request

##### header Parameters

|     |     |
| --- | --- |
| Accept | string<br>Value:"application/json" |

##### Request Body schema: application/json

|     |     |
| --- | --- |
| issuerSegmentId<br>required | integer <int32> <br>[This field must contain a valid VAU issuer segment id]<br>Example: 2 |
| stopadvices<br>required | Array of objects<br>[List of stop advice] |
| Array

|     |     |
| --- | --- |
| cardAcceptorId<br>required | string<br>[This field must contain card acceptor id.]<br>Example: "89389898" |
| cardholderAccountNumber<br>required | string<br>[This field must contain the account number (Visa, Mastercard, American Express, or Discover).]<br>Example: "400000XX00000000" |
| merchantName<br>required | string<br>[This field must contain merchant name.]<br>Example: "TestMerchant" |
| startDate | string <date> <br>[This field contains the start date, which shouldn't be less than the current date, and its format is yyyy-mm-dd, the default value is the current date.] |

#### Responses

200
This response code will be returned in scenarios where the stop advice is successful, all possible response codes are explained below in the model.

##### Response Schema: application/json

|     |     |
| --- | --- |
| issuerSegmentId<br>required | integer <int32> <br>[This field must contain a valid VAU issuer segment id.]<br>Example: 2 |
| rejects<br>required | Array of objects<br>[List of rejected stop advice responses] |
| Array

|     |     |
| --- | --- |
| cardAcceptorId<br>required | string<br>[This field must contain card acceptor id.]<br>Example: "89389898" |
| cardholderAccountNumber<br>required | string<br>[This field must contain the account number (Visa, Mastercard, American Express, or Discover).]<br>Example: "400000XX00000000" |
| merchantName<br>required | string<br>[This field must contain merchant name.]<br>Example: "TestMerchant" |
| rejectCode | string<br>[This field contains one of the following reject codes:<br>- H—Account number does not start with 2, 3, 4, 5 or 6<br>- G—Account number contains non-numeric characters or is blank<br>- L—Account number is not of proper length (must be 13, 15, 16 or 19)<br>- M—Account number is not mod 10 compliant<br>- N—No stop advice applied, unable to find merchant information for the requested card acceptor id<br>- R—Account number is not associated with requested segment id<br>- S—Start date must not be less than the current date<br>- D—Duplicate stop advice in the request<br>- I—Mandatory field cardholderAccountNumber is missing or blank in the request<br>- J—Mandatory field cardAcceptorId is missing or blank in the request<br>- K—Mandatory field merchantName is missing or blank in the request<br>- F—Stop advice is already placed for requested account number and merchant]<br>Example: "G" |
| rejectMessage | string<br>[This field contains the description of reject message:<br>- H—Account number does not start with 2, 3, 4, 5 or 6<br>- G—Account number contains non-numeric characters or is blank<br>- L—Account number is not of proper length (must be 13, 15, 16 or 19)<br>- M—Account number is not mod 10 compliant<br>- N—No stop advice applied, unable to find merchant information for the requested card acceptor id<br>- R—Account number is not associated with requested segment id<br>- S—Start date must not be less than the current date<br>- D—Duplicate stop advice in the request<br>- I—Mandatory field cardholderAccountNumber is missing or blank in the request<br>- J—Mandatory field cardAcceptorId is missing or blank in the request<br>- K—Mandatory field merchantName is missing or blank in the request<br>- F—Stop advice is already placed for requested account number and merchant]<br>Example: "Account Number contains non-numeric characters or is blank" |
| startDate | string <date> <br>[This field contains the start date, which shouldn't be less than the current date, and its format is yyyy-mm-dd, the default value is the current date.] | |
| responses<br>required | Array of objects<br>[List of successful stop advice responses] |
| Array

|     |     |
| --- | --- |
| cardAcceptorId<br>required | string<br>[This field must contain card acceptor id.]<br>Example: "89389898" |
| cardholderAccountNumber<br>required | string<br>[This field must contain the account number (Visa, Mastercard, American Express, or Discover).]<br>Example: "400000XX00000000" |
| merchantName<br>required | string<br>[This field must contain merchant name.]<br>Example: "TestMerchant" |
| responseCode | string<br>[This field contains one of the following response codes:<br>- 1—Stop advice applied in both RTVAU and VAU<br>- 2—Stop advice applied in VAU<br>- 3—Stop advice applied in RTVAU<br>Example: "1" |
| responseMessage | string<br>[This field contains the description of the response message:<br>- 1—Stop advice applied in both RTVAU and VAU<br>- 2—Stop advice applied in VAU<br>- 3—Stop advice applied in RTVAU<br>Example: "Stop advice applied in both RTVAU and VAU" |
| startDate | string <date> <br>[This field contains the start date, which shouldn't be less than the current date, and its format is yyyy-mm-dd, the default value is the current date.] | |