- [JSON representation](https://developers.google.com/pay/korea-cards-v1/payment-integrator-korea-cards-api/AddressVerificationResult#SCHEMA_REPRESENTATION)
- [AddressVerificationNotSent](https://developers.google.com/pay/korea-cards-v1/payment-integrator-korea-cards-api/AddressVerificationResult#AddressVerificationNotSent)
  - [JSON representation](https://developers.google.com/pay/korea-cards-v1/payment-integrator-korea-cards-api/AddressVerificationResult#AddressVerificationNotSent.SCHEMA_REPRESENTATION)
- [NotSentAvsSupport](https://developers.google.com/pay/korea-cards-v1/payment-integrator-korea-cards-api/AddressVerificationResult#NotSentAvsSupport)
- [AddressVerificationSentUnsupported](https://developers.google.com/pay/korea-cards-v1/payment-integrator-korea-cards-api/AddressVerificationResult#AddressVerificationSentUnsupported)
  - [JSON representation](https://developers.google.com/pay/korea-cards-v1/payment-integrator-korea-cards-api/AddressVerificationResult#AddressVerificationSentUnsupported.SCHEMA_REPRESENTATION)
- [AvsNotSupportedReason](https://developers.google.com/pay/korea-cards-v1/payment-integrator-korea-cards-api/AddressVerificationResult#AvsNotSupportedReason)
- [AddressVerificationSentResult](https://developers.google.com/pay/korea-cards-v1/payment-integrator-korea-cards-api/AddressVerificationResult#AddressVerificationSentResult)
  - [JSON representation](https://developers.google.com/pay/korea-cards-v1/payment-integrator-korea-cards-api/AddressVerificationResult#AddressVerificationSentResult.SCHEMA_REPRESENTATION)
- [VerificationResult](https://developers.google.com/pay/korea-cards-v1/payment-integrator-korea-cards-api/AddressVerificationResult#VerificationResult)

The result of verifying the address fields provided in the request.

All fields are required because we want an explicit result for each field rather than relying on the absence of a field as an implied result.

| JSON representation |
|---|
| ``` { // The following is a list of mutually exclusive fields. At most one of the // fields will be set in a response: "notSent": { object (`https://developers.google.com/pay/korea-cards-v1/payment-integrator-korea-cards-api/AddressVerificationResult#AddressVerificationNotSent`) }, "sentUnsupported": { object (`https://developers.google.com/pay/korea-cards-v1/payment-integrator-korea-cards-api/AddressVerificationResult#AddressVerificationSentUnsupported`) }, "result": { object (`https://developers.google.com/pay/korea-cards-v1/payment-integrator-korea-cards-api/AddressVerificationResult#AddressVerificationSentResult`) } // End of mutually exclusive fields. } ``` |

| Fields ||
|---|---|
| **REQUIRED**: The address verification result type. The following is a list of mutually exclusive fields. At most one of the fields will be set in a response: ||
| `notSent` | ``object (`https://developers.google.com/pay/korea-cards-v1/payment-integrator-korea-cards-api/AddressVerificationResult#AddressVerificationNotSent`)`` Google did not send `addressVerificationData`. |
| `sentUnsupported` | ``object (`https://developers.google.com/pay/korea-cards-v1/payment-integrator-korea-cards-api/AddressVerificationResult#AddressVerificationSentUnsupported`)`` Google sent `addressVerificationData` but AVS is unsupported. |
| `result` | ``object (`https://developers.google.com/pay/korea-cards-v1/payment-integrator-korea-cards-api/AddressVerificationResult#AddressVerificationSentResult`)`` The result of the address verification when `addressVerificationData` was sent. |
| End of mutually exclusive fields. ||

## AddressVerificationNotSent

Google did not send `addressVerificationData` so nothing could be done.

| JSON representation |
|---|
| ``` { "support": enum (`https://developers.google.com/pay/korea-cards-v1/payment-integrator-korea-cards-api/AddressVerificationResult#NotSentAvsSupport`) } ``` |

| Fields ||
|---|---|
| `support` | ``enum (`https://developers.google.com/pay/korea-cards-v1/payment-integrator-korea-cards-api/AddressVerificationResult#NotSentAvsSupport`)`` **REQUIRED** : If `addressVerificationData` had been sent, the following support would have been available. |

## NotSentAvsSupport

If `addressVerificationData` had been sent, the following support would have been available.

| Enums ||
|---|---|
| `NOT_SENT_AVS_SUPPORT_UNSPECIFIED` | Do not ever set this default value! |
| `UNSUPPORTED_BY_INTEGRATOR` | If `addressVerificationData` had been sent, the integrator would not have been able to support it. |
| `UNSUPPORTED_BY_NETWORK` | If `addressVerificationData` had been sent, the network would not have been able to support it. |
| `UNSUPPORTED_BY_ISSUER` | If `addressVerificationData` had been sent, the issuer would not have been able to support it. |
| `SUPPORTED` | If `addressVerificationData` had been sent, the integrator would have been able to support it. |
| `AVS_SUPPORT_NOT_KNOWN` | If `addressVerificationData` had been sent, it is unknown if it would have been supported or not. |

## AddressVerificationSentUnsupported

Google sent `addressVerificationData` but AVS is unsupported.

| JSON representation |
|---|
| ``` { "reason": enum (`https://developers.google.com/pay/korea-cards-v1/payment-integrator-korea-cards-api/AddressVerificationResult#AvsNotSupportedReason`) } ``` |

| Fields ||
|---|---|
| `reason` | ``enum (`https://developers.google.com/pay/korea-cards-v1/payment-integrator-korea-cards-api/AddressVerificationResult#AvsNotSupportedReason`)`` **REQUIRED** : The `addressVerificationData` was sent but Address Verification could not be performed for the following reason. |

## AvsNotSupportedReason

The reason Address Verification could not be performed.

| Enums ||
|---|---|
| `AVS_NOT_SUPPORTED_REASON_UNSPECIFIED` | Do not ever set this default value! |
| `UNSUPPORTED_BY_INTEGRATOR` | The integrator could not support Address Verification for this request. |
| `UNSUPPORTED_BY_NETWORK` | The network could not support Address Verification for this request. |
| `UNSUPPORTED_BY_ISSUER` | The issuer could not support Address Verification for this request. |

## AddressVerificationSentResult

Google sent `addressVerificationData` and this is the result.

| JSON representation |
|---|
| ``` { "rawAvsResult": string, "addressLine": enum (`https://developers.google.com/pay/korea-cards-v1/payment-integrator-korea-cards-api/AddressVerificationResult#VerificationResult`), "localityName": enum (`https://developers.google.com/pay/korea-cards-v1/payment-integrator-korea-cards-api/AddressVerificationResult#VerificationResult`), "administrativeAreaName": enum (`https://developers.google.com/pay/korea-cards-v1/payment-integrator-korea-cards-api/AddressVerificationResult#VerificationResult`), "postalCodeNumber": enum (`https://developers.google.com/pay/korea-cards-v1/payment-integrator-korea-cards-api/AddressVerificationResult#VerificationResult`), "countryCode": enum (`https://developers.google.com/pay/korea-cards-v1/payment-integrator-korea-cards-api/AddressVerificationResult#VerificationResult`), "nameOnCard": enum (`https://developers.google.com/pay/korea-cards-v1/payment-integrator-korea-cards-api/AddressVerificationResult#VerificationResult`) } ``` |

| Fields ||
|---|---|
| `rawAvsResult` | `string` **REQUIRED**: The raw AVS value returned from the card network. If `addressVerificationData` was not set in the request, or if the raw result is not known then the value should be "UNKNOWN". |
| `addressLine` | ``enum (`https://developers.google.com/pay/korea-cards-v1/payment-integrator-korea-cards-api/AddressVerificationResult#VerificationResult`)`` **REQUIRED** : The result of verifying the `streetAddress` sent in the `addressVerificationSystemData` field of the request. |
| `localityName` | ``enum (`https://developers.google.com/pay/korea-cards-v1/payment-integrator-korea-cards-api/AddressVerificationResult#VerificationResult`)`` **REQUIRED** : The result of verifying the `localityName` sent in the `addressVerificationSystemData` field of the request. |
| `administrativeAreaName` | ``enum (`https://developers.google.com/pay/korea-cards-v1/payment-integrator-korea-cards-api/AddressVerificationResult#VerificationResult`)`` **REQUIRED** : The result of verifying the `administrativeAreaName` sent in the `addressVerificationSystemData` field of the request. |
| `postalCodeNumber` | ``enum (`https://developers.google.com/pay/korea-cards-v1/payment-integrator-korea-cards-api/AddressVerificationResult#VerificationResult`)`` **REQUIRED** : The result of verifying the `postalCodeNumber` sent in the `addressVerificationSystemData` field of the request. |
| `countryCode` | ``enum (`https://developers.google.com/pay/korea-cards-v1/payment-integrator-korea-cards-api/AddressVerificationResult#VerificationResult`)`` **REQUIRED** : The result of verifying the `countryCode` sent in the `addressVerificationSystemData` field of the request. |
| `nameOnCard` | ``enum (`https://developers.google.com/pay/korea-cards-v1/payment-integrator-korea-cards-api/AddressVerificationResult#VerificationResult`)`` **REQUIRED** : The result of verifying the `nameOnCard` sent in the `card` field of this request. |

## VerificationResult

The result of verifying the `nameOnCard` sent in the `card` field of this request.

| Enums ||
|---|---|
| `VERIFICATION_RESULT_UNSPECIFIED` | Do not ever set this default value! |
| `MATCH` | Google sent the field to the integrator and it was checked via AVS and it matched the expected value. |
| `MISMATCH` | Google sent the field to the integrator and it was checked via AVS but did not match the expected value. |
| `NOT_SPECIFIED` | Google sent the field to the integrator and the integrator checked the field via AVS, but the AVS result code does not provide enough info for the integrator to know if the field matched the expected the value. |
| `SKIPPED_BY_NETWORK` | Google sent the field to the integrator but the Network did not return an AVS result (due to timeout etc.). |
| `SKIPPED_BY_ISSUER` | Google sent the field to the integrator but the issuer did not perform AVS (due to timeout etc.). |