2007
Table Of Contents
- Name-Value Pair API Reference for Germany
- Preface
- Overview
- Accepting PayPal in Express Checkout
- Basic Checkout with PayPal
- Support giropay and electronic funds transfer
- Controlling the Shipping Address Using SetExpressCheckout
- Changing the Language on the PayPal Login Page Using SetExpressCheckout
- Changing the Logo on the PayPal Pages Using SetExpressCheckout
- Form-Filling Your Payment Review Page Using GetExpressCheckoutDetails
- Making a Sale Using DoExpressCheckoutPayment
- Changing the URL for IPN Using DoExpressCheckoutPayment
- Including Line Item Details Using DoExpressCheckoutPayment
- Including Subtotals Using DoExpressCheckoutPayment
- Updating Order Details Using DoExpressCheckoutPayment
- Updating the Shipping Address Using DoExpressCheckoutPayment
- Back-Office Administration
- NVP API Method and Field Reference
- Error Message Reference
- NVP API Web Samples
- The Java SDK
- The ASP.NET SDK
- Country Codes
- Index
Name-Value Pair API Developer Guide and Reference April 2007 19
Accepting PayPal in Express Checkout
Basic Checkout with PayPal
2
3. Getting Payer Details Using GetExpressCheckoutDetails
The GetExpressCheckoutDetails method returns information about the customer,
including name and address stored on PayPal.
You must always include the following parameters in GetExpressCheckoutDetails:
z TOKEN: use the value from SetExpressCheckout response
The response contains this TOKEN and customer details.
Make sure TOKEN matches the value in SetExpressCheckout response.
Save PAYERID for use on the next call.
4. Making a Sale Using DoExpressCheckoutPayment
Request to obtain payment with PayPal Express Checkout using
DoExpressCheckoutPayment request.
By default, you make a final sale with DoExpressCheckoutPayment request.
You must always include the following parameters in DoExpressCheckoutPayment
request:
z TOKEN: use the value from GetExpressCheckoutDetails response
z PAYERID: use the value from GetExpressCheckoutDetails response
z PAYMENTACTION: set to Sale. This is the default value in SetExpressCheckout.
z AMT: use the same value as in SetExpressCheckout request
EXAMPLE 2.2 Getting Payer Details
Request
[requiredSecurityParameters]
&METHOD=GetExpressCheckoutDetails&
TOKEN=EC-3DJ78083ES565113B
Response
[successResponseFields]
&TOKEN=EC-3DJ78083ES565113B&EMAIL=abcdef@anyemail.com&
PAYERID=95HR9CM6D56Q2&PAYERSTATUS=verified&FIRSTNAME=John&LASTNAME=Smith&
COUNTRYCODE=US&SHIPTONAME=John Smith&SHIPTOSTREET=144+Main+St.&
SHIPTOCITY=San+Jose&SHIPTOSTATE=CA&SHIPTOCOUNTRYCODE=US&
SHIPTOZIP=99221&ADDRESSID=PayPal&
ADDRESSSTATUS=Confirmed
EXAMPLE 2.3 Making a Sale
Request
[requiredSecurityParameters]
&METHOD=DoExpressCheckoutPayment&
TOKEN=EC-0E881823PA052770A&AMT=10.00&
PAYERID=95HR9CM6D56Q2&PAYMENTACTION=Sale