BillingAddress

Contains the user's billing-related details (cardholder information) for Address Verification System (AVS) processing and for populating records at the payment gateway. This object is optional; passing null or omitting it maintains backward compatibility. This object is request-only and is not returned in API responses.

Validation & Error Handling

If any field inside billingAddress fails its length or format validation rules (for example, an invalid email format in billingEmailId or a string that exceeds the specified character limit), the API rejects the request before contacting the gateway.

  • HTTP Status: 422 Unprocessable Entity
  • Behavior: The transaction is aborted before the payment processor is contacted.

Gateway Processing & Data Security

Gateway Forwarding

  • Aurus Gateway: Full support. Forwards billingAddress data to Aurus for AVS checks.
  • Other Payment Gateways: Gracefully ignore billingAddress without returning an error.

Data Privacy & Log Masking

  • Masked PII: billingFirstName, billingLastName, billingEmailId, and billingMobileNumber are redacted or masked in stored application and audit logs.
  • Unmasked Address Information: billingAddressLine1, billingAddressLine2, billingCity, billingState, billingCountry, and billingZip remain visible in logs to facilitate AVS decline analysis.
  • billingAddressLine1
    Type: string | null
    max length:  
    100

    Primary street address.

  • billingAddressLine2
    Type: string | null
    max length:  
    100

    Apartment, suite, unit, or building line.

  • billingCity
    Type: string | null
    max length:  
    50

    City name.

  • billingCountry
    Type: string | null
    max length:  
    50

    Country name or ISO code.

  • billingEmailId
    Type: string | null
    max length:  
    100    Format: email

    Email address of the user or cardholder. Masked in audit logs.

  • billingFirstName
    Type: string | null
    max length:  
    50

    First name of the user or cardholder. Masked in audit logs.

  • billingLastName
    Type: string | null
    max length:  
    50

    Last name of the user or cardholder. Masked in audit logs.

  • billingMobileNumber
    Type: string | null
    max length:  
    20

    Mobile number of the user or cardholder. Masked in audit logs.

  • billingState
    Type: string | null
    max length:  
    50

    State, Province, Region name, or code.

  • billingZip
    Type: string | null
    min length:  
    3
    max length:  
    10

    Postal or ZIP code.

Previous
PurchaseRequest
Next
RedeemGiftCardResponseModel
Copyright © 2026 PAR Technology Corporation. All rights reserved.
PAR Technology Corporation 8383 Seneca Turnpike, Suite 3 New Hartford, New York 13413 (315) 738-0600 legal@partech.com. PAR Tech is a leading global provider of software, systems, and service solutions to the restaurant and retail industries. You may learn about its product offerings here.
Before using this application, please read the PAR Tech Terms of Use. In addition, the sample applications of PAR Technology are licensed under the terms of the O'Saasy License.