2007

Accepting PayPal in Express Checkout
Basic Checkout with PayPal
2
18 April 2007 Name-Value Pair API Developer Guide and Reference
1. Starting the Checkout Using SetExpressCheckout
The SetExpressCheckout request method notifies PayPal that you are using Express
Checkout to obtain payment from your customer.
You must always include the following parameters in SetExpressCheckout request:
z AMT
z RETURNURL
z CANCELURL
You are also advised to include the following parameters to ensure a smooth flow in case the
funding methods giropay or electronic funds transfer are being used:
z GIROPAYSUCCESSURL
z GIROPAYFAILURL
z BANKTXNPENDINGURL
N OTE: Because we do not specify a value for PAYMENTACTION, this parameter defaults to
Sale.
Save TOKEN for use on the remaining Express Checkout calls.
2. Redirecting the Customer’s Browser to PayPal Login Page
After you receive a successful response from SetExpressCheckout, add the TOKEN from
SetExpressCheckout response as a name/value pair to the following URL, and redirect
your customer’s browser to it:
https://www.paypal.com/cgi-bin/webscr?cmd=_express-checkout&
token=value_from_SetExpressCheckoutResponse
For redirecting the customer’s browser to the PayPal login page, PayPal recommends that you
use the HTTPS response 302 “Object Moved” with the URL above as the value of the
Location header in the HTTPS response. Ensure that you use an SSL-enabled server to
prevent browser warnings about a mix of secure and insecure graphics.
EXAMPLE 2.1 Starting the Checkout
Request
[requiredSecurityParameters]
&METHOD=SetExpressCheckout&AMT=10.00&
RETURNURL=https://www.anycompany.com/orderprocessing/orderreview.html&
CANCELURL=https://www.anycompany.com/orderprocessing/shippinginfo.html
Response
[successResponseFields]
&TOKEN=EC-3DJ78083ES565113B