Developer's Guide

Performing Direct Payment Credit Card Transactions
Parameters Used in Transactions
4
28 Website Payments Pro Developer’s Guide
MERCHANTSESSIONID Your customer Direct Payment session
identification token.
PayPal records this session token as an
additional means to detect possible fraud.
No String 64
NAME Information (Next two table entries)
FIRSTNAME Account holder's first name. No, but
recom-
mended
Alpha 25
LASTNAME Account holders last name. No, but
recom-
mended
Alpha 25
NOTIFYURL Your URL for receiving Instant Payment
Notification (IPN) about this transaction.
If you do not specify NOTIFYURL in the
request, the notification URL from your
Merchant Profile is used, if one exists.
No Alpha-
numeric
2048
ORDERDESC Description of items the
customer is
purchasing.
No Alpha-
numeric
127
ORIGID ID of the original Direct Payment transaction
that is being referenced. This ID is returned by
the PNREF parameter and appears as the
Transaction ID in PayPal Manager reports.
Limitations: This value is case-sensitive.
Yes
a
Alpha-
numeric
12
RECURRINGTYPE Type of transaction occurrence. The values are:
F = First occurrence
S = Subsequent occurrence (default)
No Alpha 1
SHIP-TO Address Information (Next five table entries)
SHIPTOSTREET Post-to postal address. No
b
String 30
SHIPTOCITY Name of post-to city. No
b
String 40
SHIPTOSTATE Name of post-to county or province. No
b
String 10
SHIPTOCOUNTRY Post-to country code. See
Appendix B, “ISO
Country Codes
.”
No
b
Alpha 2
SHIPTOZIP US post-to ZIP code or other country-specific
postcode.
No
b
String 20
T
ABLE 4.1 Transaction parameters (Continued)
Parameter Description Required Type
Max.
Length