Integration Guide
Table Of Contents
- PayPal Express Checkout Integration Guide
- Contents
- Preface
- Getting Started With Express Checkout
- Express Checkout User Interface Requirements
- Related API Operations
- Integrating Express Checkout With PayPal SDKs
- Going Live With Your Express Checkout Integration
- Obtaining API Credentials
- PayPal Name-Value Pair API Basics
- PayPal SOAP API Basics
- PayPal WSDL/XSD Schema Definitions
- PayPal SOAP API Definitions
- Security
- SOAP RequesterCredentials: Username, Password, Signature, and Subject
- SOAP Service Endpoints
- SOAP Request Envelope
- Request Structure
- SOAP Message Style: doc-literal
- Response Structure
- Error Responses
- CorrelationID for Reporting Problems to PayPal
- UTF-8 Character Encoding
- Date/Time Formats
- Core Currency Amount Data Type
Express Checkout Integration Guide August 7, 2012 39
3
Related API Operations
When you create the simplest Express Checkout integration, you specify Sale as the payment
action, enabling you to receive the money right away. You can also set up a payment to be
collected later, or refund a payment.
Sale Payment Action for Express Checkout
A sale payment action represents a single payment that completes a purchase for a specified
amount.
A sale is the default Express Checkout payment action; however, you can also specify the
following action in your SetExpressCheckout and DoExpressCheckoutPayment
requests:
PAYMENTREQUEST_n_PAYMENTACTION=Sale
A sale is the most straightforward payment action. Choose this payment action if the
transaction, including shipping of goods, can be completed immediately. To use this payment
action:
The final amount of the payment must be known when you invoke the
DoExpressCheckoutPayment API operation
You should intend to fulfill the order immediately, such as would be the case for digital
goods or for items you have in stock for immediate shipment
After you execute the DoExpressCheckoutPayment API operation, the payment is
complete and further action is unnecessary. You cannot capture a further payment or void any
part of the payment when you use this payment action.
Authorization Payment Action for Express Checkout
An authorization payment action represents an agreement to pay and places the buyer’s funds
on hold for up to three days.
To set up an authorization, specify the following payment action in your
SetExpressCheckout and DoExpressCheckoutPayment requests:
PAYMENTREQUEST_n_PAYMENTACTION=Authorization