2007

Table Of Contents
Name-Value Pair API Developer Guide and Reference April 2007 37
NVP API Method and Field Reference
Express Checkout
GIROPAYCANCELURL URL of your website where the user gets redirected when a giropay
or electronic funds transfer transaction fails.
No
(recommended)
BANKTXNPENDINGURL URL of your website where the user gets redirected when he has
initiated an electronic funds transfer.
No
(recommended)
AMT The total cost of the order to the customer. If shipping cost and tax
charges are known, include them in this value; if not, this value
should be the current sub-total of the order.
N OTE: Limitations: Must not exceed $10,000 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 (,).
Yes
CURRENCYCODE A three-character currency code for one of the currencies listed in
PayPal-Supported Transactional Currencies
. Default: USD.
No
MAXAMT The expected maximum total amount of the complete order,
including shipping cost and tax charges.
N OTE: Limitations: Must not exceed $10,000 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 (,).
No
PAYMENTACTION How you want to obtain payment:
z Sale indicates that this is a final sale for which you are
requesting payment.
Character length and limit: Up to 13 single-byte alphabetic
characters
Allowable Values:
z Authorization
z Order
z Sale
Default: The transaction resulting from
DoExpressCheckoutPayment request will be a final sale..
No
EMAIL Email address of the buyer as entered during checkout. PayPal uses
this value to pre-fill the PayPal membership sign-up portion of the
PayPal login page.
Character length and limit: 127 single-byte alphanumeric characters
No
DESC Description of items the customer is purchasing.
Character length and limitations: 127 single-byte alphanumeric
characters
No
T
ABLE A.2 SetExpressCheckout Request Parameters (Continued)
Parameter Description Required