Captures the customer’s billing address, contact info, and company details.
Transaction Details - Billing Address
Billing Information
| Variable | Requirement | Type | Possible Values / Example | Description | Notes |
|---|---|---|---|---|---|
pt_billing_name |
Mandatory | string | John Smith | Full customer name as it appears on the credit card. | Used for payment authorization matching. |
pt_billing_first_name |
Optional | string | John | Billing first name. | Should match cardholder details when available. |
pt_billing_last_name |
Optional | string | Smith | Billing last name. | Should match cardholder details when available. |
pt_billing_address_1 |
Mandatory | string | 123 Elm Drive | Primary billing street address. | Required for AVS validation. |
pt_billing_address_2 |
Optional | string | Apt 2B | Secondary address line (suite/unit). | Optional extension of address. |
pt_billing_city |
Mandatory | string | Townsville | Billing city. | Used for address verification. |
pt_billing_state |
Mandatory | string | NY | Billing state or region code. | Use standard state/province abbreviations where applicable. |
pt_billing_province |
Optional | string | ON | International province/region. | For non-US/Canada addresses, set pt_billing_state = ZZ and use this field for province name. |
pt_billing_postal_code |
Mandatory | string | 12345-6789 | Billing postal/ZIP code. | Must match country-specific postal format. |
pt_billing_country |
Mandatory | string | US | Two-character ISO country code. | Refer to ISO 3166-1 alpha-2 standard. |
pt_billing_email_address |
Optional | string | person@place.com | Customer email address. | Used for sending transaction confirmations. |
pt_billing_phone_number |
Optional | string | 555-234-5678 | Customer contact number. | May be used for fraud verification or support. |
pt_billing_company |
Optional | string | Some Business Name | Billing company name. | Primarily used for business transactions. |
pt_billing_fax_number |
Optional | string | 555-234-5678 | Billing fax number. | Legacy contact field; rarely required. |