Customer's primary billing address information. **Note:** Required for 3DS. Please refer to the 3D Secure API specification for format requirements.
address_2
string
Customer's secondary billing address information.
address_3
string
Customer's third billing address information.
city
string
Customer's city on their billing address. **Note:** Required for 3DS. Please refer to the 3D Secure API specification for format requirements.
country_code
string
Customer's alpha-2 ISO 3166 country code (e.g. `US` for United States). **Note:** Required for 3DS. Please refer to the 3D Secure API specification for format requirements.
first_name
string
Customer's first name. **Required** when `company_name` is not provided. **Note:** Required for 3DS. Please refer to the 3D Secure API specification for format requirements.
middle_name
string
Customer's middle name.
last_name
string
Customer's last name. **Required** when `company_name` is not provided. **Note:** Required for 3DS. Please refer to the 3D Secure API specification for format requirements.
phone
string
Customer's phone number for the billing address.
postal_code
string
Customer's postal code for their billing address. **Note:** Required for 3DS unless a market or regional mandate restricts sending this information.
state
string
Customer's state or province for their billing address (e.g. `OH` for Ohio, `TX` for Texas).
{
"$schema": "http://json-schema.org/draft-07/schema#",
"$id": "https://raw.githubusercontent.com/api-evangelist/verifone/refs/heads/main/json-schema/customer-api-billing.json",
"title": "Billing",
"description": "Billing from Customer API",
"type": "object",
"properties": {
"address_1": {
"maxLength": 40,
"type": "string",
"description": "Customer's primary billing address information.\n\n**Note:** Required for 3DS. Please refer to the 3D Secure API specification for format requirements."
},
"address_2": {
"maxLength": 40,
"type": "string",
"description": "Customer's secondary billing address information."
},
"address_3": {
"maxLength": 40,
"type": "string",
"description": "Customer's third billing address information."
},
"city": {
"maxLength": 28,
"type": "string",
"description": "Customer's city on their billing address.\n\n**Note:** Required for 3DS. Please refer to the 3D Secure API specification for format requirements."
},
"country_code": {
"type": "string",
"description": "Customer's alpha-2 ISO 3166 country code (e.g. `US` for United States).\n\n**Note:** Required for 3DS. Please refer to the 3D Secure API specification for format requirements."
},
"first_name": {
"maxLength": 22,
"type": "string",
"description": "Customer's first name. **Required** when `company_name` is not provided.\n\n**Note:** Required for 3DS. Please refer to the 3D Secure API specification for format requirements."
},
"middle_name": {
"maxLength": 22,
"type": "string",
"description": "Customer's middle name."
},
"last_name": {
"maxLength": 22,
"type": "string",
"description": "Customer's last name. **Required** when `company_name` is not provided.\n\n**Note:** Required for 3DS. Please refer to the 3D Secure API specification for format requirements."
},
"phone": {
"maxLength": 25,
"pattern": "^[0-9\\s\\-+().-]+$",
"type": "string",
"description": "Customer's phone number for the billing address."
},
"postal_code": {
"maxLength": 10,
"type": "string",
"description": "Customer's postal code for their billing address.\n\n**Note:** Required for 3DS unless a market or regional mandate restricts sending this information."
},
"state": {
"maxLength": 35,
"type": "string",
"description": "Customer's state or province for their billing address (e.g. `OH` for Ohio, `TX` for Texas)."
}
}
}