Integration Guide
Table Of Contents
- Preface
- How Website Payments Standard Works
- Using Your Merchant Account Profile and Tools
- The Account Profile Summary
- Branding PayPal’s Payment Pages
- Streamlining Purchases with Website Payment Preferences
- Blocking Certain Kinds of Payment
- Adding Your Credit Card Statement Name
- Getting Customer Contact Telephone Numbers
- Language Encoding Your Data
- Multi-User Access to Your PayPal Account
- PayPal-Supported Currencies
- Issuing Refunds
- Single-Item Payment: Buy Now and Donations
- Multiple-Item Payment: Shopping Cart
- Encrypted Website Payments
- Testing in the PayPal Sandbox
- Website Payments Standard HTML FORM Basics
- Website Payments Standard HTML Variables
- Country Codes
- Index
Website Payments Standard Checkout Integration Guide November 2005 103
Website Payments Standard HTML Variables
A
TABLE A.5 HTML Variables: Transaction Information
Name Description
Required or
Optional
Character
Length
address_
override
1: The address specified in prepopulation variables overrides the
user’s stored address. See
Table A.8, “HTML Variables:
Prepopulating PayPal FORMs or Address Overriding
. The
customer is shown the passed-in address but cannot edit it. If the
address is not valid such as missing any required fields, including
country) or not included, no address is shown.
Optional 1
currency_
code
The currency of the payment. Defines the currency in which the
monetary variables (
amount, shipping, shipping2,
handling, tax) are denoted.
Default: all monetary fields are interpreted as U.S. Dollars.
Optional
custom Passthrough variable never presented to your customer.
Default: no variable is passed back to you.
Optional 256
handling Handling charges. This is not quantity-specific. The same
handling cost is charged regardless of the number of items
purchased.
Default: no handling charges are included.
Optional
invoice Passthrough variable you can use to identify your invoice
number for this purchase.
Default: no variable is passed back to you.
Optional 256
redirect_cmd Used only in conjunction with cmd=”_ext-enter” for
prepopulating a PayPal FORM during payment.
The only valid value for redirect_cmd is _xclick.
Optional
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 is charged regardless of the quantity of
items purchased.
NOTE: The shipping variable takes effect only if the override
checkbox is checked in your Profile. See
“Overriding
Shipping Calculation on Individual Transactions” on
page 46
.
Default: if Profile-based shipping is enabled, customer is charged
the amount or percentage defined in your Profile.
Optional
shipping2 The cost of shipping each additional item. If omitted, and
Profile-based shipping is enabled, your customer is charged the
amount or percentage defined in your Profile.
Optional