1
0
Files
PayPal-PHP-Server-SDK/doc/models/portable-postal-address-medium-grained.md
2024-11-21 17:43:29 +00:00

3.0 KiB

Portable Postal Address Medium Grained

The portable international postal address. Maps to AddressValidationMetadata and HTML 5.1 Autofilling form controls: the autocomplete attribute.

Structure

PortablePostalAddressMediumGrained

Fields

Name Type Tags Description Getter Setter
addressLine1 ?string Optional The first line of the address, such as number and street, for example, 173 Drury Lane. Needed for data entry, and Compliance and Risk checks. This field needs to pass the full address.
Constraints: Maximum Length: 300
getAddressLine1(): ?string setAddressLine1(?string addressLine1): void
addressLine2 ?string Optional The second line of the address, for example, a suite or apartment number.
Constraints: Maximum Length: 300
getAddressLine2(): ?string setAddressLine2(?string addressLine2): void
adminArea2 ?string Optional A city, town, or village. Smaller than admin_area_level_1.
Constraints: Maximum Length: 120
getAdminArea2(): ?string setAdminArea2(?string adminArea2): void
adminArea1 ?string Optional The highest-level sub-division in a country, which is usually a province, state, or ISO-3166-2 subdivision. This data is formatted for postal delivery, for example, CA and not California. Value, by country, is:
  • UK. A county.
  • US. A state.
  • Canada. A province.
  • Japan. A prefecture.
  • Switzerland. A kanton.

Constraints: Maximum Length: 300
getAdminArea1(): ?string setAdminArea1(?string adminArea1): void
postalCode ?string Optional The postal code, which is the ZIP code or equivalent. Typically required for countries with a postal code or an equivalent. See postal code.
Constraints: Maximum Length: 60
getPostalCode(): ?string setPostalCode(?string postalCode): void
countryCode string Required The 2-character ISO 3166-1 code that identifies the country or region.
Note: The country code for Great Britain is GB and not UK as used in the top-level domain names for that country. Use the C2 country code for China worldwide for comparable uncontrolled price (CUP) method, bank card, and cross-border transactions.

Constraints: Minimum Length: 2, Maximum Length: 2, Pattern: ^([A-Z]{2}|C2)$
getCountryCode(): string setCountryCode(string countryCode): void

Example (as JSON)

{
  "address_line_1": "address_line_16",
  "address_line_2": "address_line_24",
  "admin_area_2": "admin_area_22",
  "admin_area_1": "admin_area_10",
  "postal_code": "postal_code6",
  "country_code": "country_code6"
}