Address Verification Service

Address verification service (AVS) is offered by select local authorization vendors, including Visa, American Express, MasterCard, and Discover. Address verification services are designed to prevent fraudulent activity by allowing a merchant to verify that a customer’s payment card address and/or postal code matches the address recorded in the card issuer's system.

When cardholder address elements are included in the authorization request, an address validation will take place at the same time. The Address Verification request detailed here supports a standalone address validation.

The payment transaction type is a standalone zero value transaction used to obtain address verification for a specific payment card number and address.

The response returns an AVS result allowing the requestor to determine transaction authenticity.

Contact your Travelport representative for endpoints for the Pay APIs.

In this topic:

Address Verification Request and Response

To request an address verification, send PaymentCardAuthorizationRequest with PaymentTransaction@authorizationType: "AAVS".

The following table details the required and optional or conditional objects.

Element Required Optional /Conditional Example

PaymentCardAuthorizationRequest

Top level object for request.

    

PaymentCardAuthorizationQueryRequest

Top level object for request.

    

PaymentCardRequest

 

      

 

airlineMerchantCode

 

AA

If not sent, error 252
 

expireDate

 

MMYY

If not sent, error 254
   

agentSignOn

ABC123BZ

 

localDateTime

 

YYYY-MM-DDTHH:MM:SS

If not sent, error 258

  approvalCode  

CA, VI, DS, AX, DC, TP, JC

If not sent, error 268

 

primaryAccountNumber

 

4444333322221111

If not sent, error 260

Minimum 16 characters, maximum 19

 

paymentCardCode

  

AA

If not sent, error 252

AgencyPCCDetail

     
 

pseudoCityCode

  

7BT
 

agencyCode

  

9999999
 

codeAffinity

  

1P/1V/1G

Cardholder

     

 

  

CardholderName

 MR BOB CITIZEN
   

AddressLine

 123 WEST STREET
   

PostalCode

 123456

Address Verification Response

The response returns the objects detailed below.

Object Description

PaymentCardAuthorizationResponse

Top level object element for response.

Key value pairs:

  • transactionId: Internal identifier for the transaction.

PaymentCardAuthorization

Provides confirmation details in the following:

  • completionCode: Code 000 is the OK response. See Pay Response Codes for other codes.
  • avsResult: See Pay Response Codes for codes.
  • PrimaryAccountNumber: The credit card number sent in the request.