Integration Guide

Website Payments Standard Checkout Integration Guide November 2005 93
Website Payments Standard HTML FORM Basics
Variations on Basic Variables
7
z item_number or item_number_x
z invoice
Setting the Character Set: charset
You can use the charset FORM variable to specify the character set or character encoding of
the data you collect in your website forms and send to PayPal. PayPal sends data to you in the
same character set or encoding you specify with the charset variable. For example, the
following INPUT tag sets the encoding to UTF-8:
<INPUT TYPE=”hidden” name=”charset” value=”utf-8”>
Setting Return URL on Individual Transactions
With Auto Return turned on in your Profile, you can set the value of the return URL on each
individual transaction, overriding the value you have stored on PayPal. For example, you
might want to return the customer’s browser to a URL on your site that is specific to that
customer, perhaps with a session ID or other transaction-related data included in the URL.
To set the return URL for a transaction, include the return variable in the HTML FORM:
<INPUT TYPE=”hidden” NAME=”return” value=”URLspecificToThisTransaction”>
Desired Currency on Individual Transactions
Use the currency_code variable on individual transactions to specify the currency of the
payment:
<INPUT TYPE=”hidden” NAME=”currency_code”
value=”PayPalSupportedCurrencyCode”>
T
ABLE 7.2 Character Sets and Encodings Supported by PayPal
Big5 (Traditional
Chinese in Taiwan)
EUC-JP
EUC-KR
EUC-TW
gb2312 (Simplified
Chinese)
gbk
HZ-GB-2312
(Traditional Chinese
in Hong Kong)
ibm-862 (Hebrew
with European
characters)
ISO-2022-CN
ISO-2022-JP
ISO-2022-KR
ISO-8859-1
(Western
European
Languages)
ISO-8859-2
ISO-8859-3
ISO-8859-4
ISO-8859-5
ISO-8859-6
ISO-8859-7
ISO-8859-8
ISO-8859-9
ISO-8859-13
ISO-8859-15
KOI8-R
(Cyrillic)
Shift_JIS
UTF-7
UTF-8
UTF-16
UTF-16BE
UTF-16LE
UTF16_Platform
Endian
UTF16_Opposit
eEndian
UTF-32
UTF-32BE
UTF-32LE
UTF32_Platform
Endian
UTF32_Opposit
eEndian
US-ASCII
windows-1250
windows-1251
windows-1252
windows-1253
windows-1254
windows-1255
windows-1256
windows-1257
windows-1258
windows-874 (Thai)
windows-949
(Korean)
x-mac-greek
x-mac-turkish
x-mac-
centraleurroman
x-mac-cyrillic
ebcdic-cp-us
ibm-1047