Integration Guide

Express Checkout ~ Integration Overview
8/16/2013 Page 13 of 18
NOTE: Only populated fields are returned in the response.
Completing the Express Checkout Transaction
To complete an Express Checkout transaction, you must invoke the
DoExpressCheckoutPayment API operation.
NOTE: This example assumes that PayPal redirects the buyer's browser to your website
with a valid token after you call the SetExpressCheckout API. Optionally, you may call
the GetExpressCheckoutDetails API before calling the DoExpressCheckoutPayment
API.
In the simplest case, set the total amount of the order when you call the
SetExpressCheckout API.
However, you can change the amount before calling the
DoExpressCheckoutPayment API if you did not know the total amount
when you called the SetExpressCheckout API.
NOTE: This example assumes the simplest case, in which the total amount was
specified in the return URL when calling the SetExpressCheckout API. Although
you can specify additional options, this example does not use any additional
options.
Specify the token returned by PayPal when it redirects the consumer's
browser to your site.
PayPal returns the token to use in the token HTTP request parameter when
redirecting to the URL you specified in your call to the SetExpressCheckout
API.
TOKEN=tokenValue
Specify the Payer ID returned by PayPal when it redirects the buyer's
browser to your website.
PayPal returns the Payer ID to use in the token HTTP request parameter
when redirecting to the URL you specified in your call to the
SetExpressCheckout API. Optionally, you can obtain the Payer ID by calling
the GetExpressCheckoutDetails API.
PAYERID=id
Specify the amount of the order including shipping, handling, and tax;
include the currency if it is not in US dollars.