Integration Guide
Table Of Contents
- What is Express Checkout?
- How Express Checkout Works
- Designing an Optimal Checkout Flow
- Integration Use Cases
- Sample Code
- Documentation
Express Checkout ~ Integration Overview
8/16/2013 Page 11 of 18
PayPal page flow and the options available to buyers. You should start by setting up a
standard Express Checkout transaction, which can be modified to include additional options.
To set up the simplest standard Express Checkout transaction:
Specify the amount of the transaction; include the currency if it is not in US dollars.
Specify the total amount of the transaction if it is known; otherwise, specify the
subtotal.
For most currencies, the amount format must have a decimal point with exactly
two digits to the right and an optional thousands separator to the left, which must
be a comma. See the PayPal currency codes page for information about currencies
that do not support decimals.
For example, EUR 2.000,00 must be specified as 2000.00 or 2,000.00.
The specified amount cannot exceed USD $10,000.00, regardless of the currency
used.
PAYMENTREQUEST_0_AMT=amount
PAYMENTREQUEST_0_CURRENCYCODE=currencyID
Specify the return URL
The return URL is your website page to which PayPal redirects the buyer's browser
after the buyer logs into PayPal and approves the payment. Typically, this is a secure
page (https://...) on your website.
NOTE: You can use the return URL to piggyback parameters between pages on
your site. For example, you can set your Return URL to specify additional
parameters using the
https://www.yourcompany.com/page.html?param=value... syntax.
The parameters become available as request parameters on the page
specified by the Return URL.
RETURNURL=return_url
Specify the cancel URL
The cancel URL is the page to which PayPal redirects the buyer’s browser
if the consumer does not approve the payment. Typically, this is the
secure page (https://...) on your website from which you redirected the
consumer to PayPal.
You can pass SetExpressCheckout request values as parameters in your
website's URL to have the values available, if necessary, after PayPal
redirects to your website's URL.
CANCELURL=cancel_url
Specify the payment action.