User's Manual
Table Of Contents
- Preface
- Introduction
- PayPal Payments Overview
- Getting Started
- PayPal Account Optional
- Creating Buy Now and Donation Buttons
- Creating Shopping Cart Buttons
- Adding PayPal to Your Third- party Shopping Cart
- Custom Payment Pages
- Calculating Shipping, Handling, and Tax
- Creating Customer Contact Telephone
- Auto Return
- Backend Integration - Payment Notifications
- Using Multiple Currencies
- Language Encoding for Your Data
- Testing
- Processing eChecks
- Security
- HTML Samples
- IPN and PDT Variables
- About These Tables of Variables
- test_ipn Variable in Sandbox
- IPN Variables in All Posts
- Buyer Information
- Basic Information
- Advanced and Custom Information
- Shopping Cart Information
- Currency and Currency Exchange
- Auctions
- Mass Payment
- Subscriptions Variables
- Dispute Notification Variables
- PDT-Specific Variables
- Country Codes
Merchant User Manual and Integration Guide May, 2005 135
HTML Samples
PayPal Buy Now and Donation Buttons HTML and Variables
A
cpp_headerb
order_color
Sets the border color around the header of the payment page. The border is a 2-
pixel perimeter around the header space, which has a maximum size of 750
pixels wide by 90 pixels high. Valid character set is 6 character HTML Hex
code in ASCII. This variable is not case-sensitive.
cpp_payflow
_color
Sets the background color for the payment page below the header. Valid
character set is 6 character HTML Hex code in ASCII. This variable is not
case sensitive. Certain background colors that conflict with PayPal’s error
messages are not allowed. For more information, see see
Chapter 8,
“Custom Payment Pages
.”
address_
override
If set to “1”, the address passed in via prepopulation fields will override the
user’s stored address. The user will be shown the passed-in address, but will
not be able to edit it. If the address is not valid (i.e. missing required fields,
including country) or not included, then no address will be shown.
cbt Sets the text for the Continue button on the PayPal Payment Complete page.
Requires Return URL to be set.
Transaction Information
currency_
code
The currency of the payment. Defines the currency in which the monetary
variables (
amount, shipping, shipping2, handling, tax) are
denoted. Possible values are “USD” (U.S. Dollar), “EUR” (Euro), “GBP”
(Pound Sterling), “CAD” (Canadian Dollar), “JPY” (Yen). If omitted, all
monetary fields will be interpreted as U.S. Dollars.
custom Pass-through variable that will never be presented to your customer. If
omitted, no variable will be passed back to you.
256
handling The cost of handling. This is not quantity-specific. The same handling will be
charged regardless of the number of items purchased. If omitted, no handling
charges will be assessed.
invoice Pass-through variable you can use to identify your Invoice Number for this
purchase. If omittted, no variable will be passed back to you.
256
shipping The cost of shipping this item if you have enabled item-specific shipping costs.
If shipping
is used and shipping2 is not defined, this flat amount will be
charged regardless of the quantity of items purchased. If you are using item-
based shipping, make sure the override check box is checked in your Profile. If
omitted, and your Profile-based shipping is enabled, your customer will be
charged the amount or percentage defined in your Profile.
shipping2 The cost of shipping each additional item. If omitted, and your Profile-based
shipping is enabled, your customer will be charged the amount or percentage
defined in your Profile
T
ABLE A.1 HTML and Hyperlink Variables for Buy Now and Donations Buttons
Name Description
Character
Length