Integration Guide
Table Of Contents
- Express Checkout Integration Guide
- Contents
 - Preface
 - Introducing Express Checkout
 - Express Checkout Button and Logo Image Integration
 - PayPal Name-Value Pair API Basics
 - Implementing the Simplest Express Checkout Integration
 - Testing an Express Checkout Integration
 - Customizing Express Checkout
 - Implementing the Instant Update API
 - Immediate Payment
 - Implementing Parallel Payments
 - Handling Payment Settlements
 - Handling Recurring Payments
- How Recurring Payments Work
 - Recurring Payments Terms
 - Options for Creating a Recurring Payments Profile
 - Recurring Payments With Express Checkout
 - Recurring Payments Profile Status
 - Getting Recurring Payments Profile Information
 - Modifying a Recurring Payments Profile
 - Billing the Outstanding Amount of a Profile
 - Recurring Payments Notifications
 
 - Using Other PayPal API Operations
 - Integrating giropay with Express Checkout
 
 
Express Checkout Integration Guide May 2010 23
Express Checkout Button and Logo Image Integration
Dynamic Image Command Reference
2
Dynamic Image Parameters
The table below describes the dynamic image name-value pair parameters. 
Dynamic-Image Command Variable Descriptions
Locale Codes
The table below lists the locale values. Country code is the two-letter code for the country. 
Language priority is the language associated with the country code where language_0 is the 
default. 
pal Type: encrypted PayPal account number 
(Optional) Unique identification number. When merchants sign up for a PayPal 
business account, PayPal assigns them an account number. The pal value 
represents the pay-to merchant account, not a third party making the API request 
on behalf of this merchant. 
NOTE: If pal is not passed, PayPal displays the default Check out with PayPal 
button.
ordertotal Type: numeric 
(Optional) The total cost of the order to the buyer. If shipping and sales tax are 
known, include them in this value. If not, this value should be the current subtotal 
of the order. 
NOTE: If ordertotal is not passed, PayPal does not display the incentive 
image even if the buyer is eligible for the incentive.
Character length and limitations: Must not exceed $10,000.00 USD in any 
currency. No currency symbol.Must have two decimal places, decimal separator 
must be a period (.), and the optional thousands separator must be a comma(,).
locale Type: string
(Optional) The five-character locale code. See Locale Codes.
Any other values default to US. 
NOTE: The merchant can participate in one campaign per country.
buttontype Type: string 
(Optional) Indicates a dynamic image. The values are: 
z (Default) Check out with PayPal button image: ecshortcut
z PayPal Acceptance Mark image: ecmark










