On this page
No Headings
The merchant business information that appears on the invoice.
objectemailstringemailThe merchant email address. This email must be listed in the merchant's PayPal profile.
If you omit this value, notifications are sent from and to the primary email address but do not appear on the invoice.
business_namestringThe merchant's business name.
first_namestringThe merchant's first name.
last_namestringThe merchant's last name.
addressobjectThe merchant's address.
line1requiredstringThe first line of the address. For example, number or street.
line2stringThe second line of the address. For example, suite or apartment number.
cityrequiredstringThe city name.
country_coderequiredstringThe two-character ISO 3166-1 code that identifies the country or region.
Note: The country code for Great Britain isGBand notUKas is used in that country's top-level domain names. Use theC2country code for China worldwide for comparable uncontrolled price (CUP) method, bank card, and cross-border transactions.
postal_codestringThe postal code, which is the zip code or equivalent. Typically required for countries with a postal code or an equivalent. See postal code.
statestringphonestringphoneThe phone number, in its canonical international E.164 numbering plan format.
phoneobjectThe merchant's phone number.
country_codestring^[0-9]{1,3}?$The country code portion of the phone number, in E.164 format.
national_numberstring^[0-9]{1,14}?$The in-country phone number, in E.164 format.
faxobjectThe merchant's fax number.
country_codestring^[0-9]{1,3}?$The country code portion of the phone number, in E.164 format.
national_numberstring^[0-9]{1,14}?$The in-country phone number, in E.164 format.
websitestringuriThe merchant's website.
tax_idstringThe merchant's tax ID.
additional_infostringAny additional information, such as business hours.