2009

Table Of Contents
Name-Value Pair API Developer Guide 08 April 2009 45
Express Checkout API Operations
SetExpressCheckout API
ALLOWNOTE (Optional) The value 1 indicates that the customer may enter a note to the merchant
on the PayPal page during checkout. The note is returned in the
GetExpressCheckoutDetails response and the DoExpressCheckoutPayment
response.
Character length and limitations: One single-byte numeric character.
Allowable values: 0, 1
ADDRESSOVERRIDE (Optional) The value 1 indicates that the PayPal pages should display the shipping
address set by you in this SetExpressCheckout request, not the shipping address on
file with PayPal for this customer.
Displaying the PayPal street address on file does not allow the customer to edit that
address.
Character length and limitations: One single-byte numeric character.
Allowable values: 0, 1
LOCALECODE (Optional) Locale of pages displayed by PayPal during Express Checkout.
Character length and limitations: Any two-character country code.
The following two-character country codes are supported by PayPal:
z AU
z DE
z FR
z IT
z GB
z ES
z US
Any other value will default to US. See “Country Codes” on page 225.
PAGESTYLE (Optional) Sets the Custom Payment Page Style for payment pages associated with
this button/link. This value corresponds to the HTML variable page_style for
customizing payment pages. The value is the same as the Page Style Name you chose
when adding or editing the page style from the Profile subtab of the My Account
tab of your PayPal account.
Character length and limitations: 30 single-byte alphabetic characters.
HDRIMG (Optional) URL for the image you want to appear at the top left of the payment page.
The image has a maximum size of 750 pixels wide by 90 pixels high. PayPal
recommends that you provide an image that is stored on a secure (https) server. If you
do not specify an image, the business name is displayed.
Character length and limit: 127 single-byte alphanumeric characters
HDRBORDERCOLOR (Optional) Sets the border color around the header of the payment page. The border is
a 2-pixel perimeter around the header space, which is 750 pixels wide by 90 pixels
high. By default, the color is black.
Character length and limitation: Six character HTML hexadecimal color code in
ASCII.
Field Description