Address object contains location information used for billing or shipping addresses.
Properties
| Field | Type | Required | Description |
|---|---|---|---|
street | string | ❌ | Street address line |
city | string | ❌ | City or locality |
country | string | ❌ | Two-letter ISO 3166 country code (e.g., “US”, “DE”) |
state | string | ❌ | State, province, or region |
zip | string | ❌ | ZIP or postal code |
Usage
Address objects are used in:- Billing - Customer’s billing address
- Shipping - Delivery address for physical goods
Address information helps with fraud prevention and may be required by some payment methods or regulations.