Prerequisites

Before you process PayPal Express Checkout payments:

■	Install a CyberSource client.

See the information about clients in Getting Started with CyberSource Advanced for the Simple Order API.

■	Contact CyberSource Customer Support to configure your CyberSource account.

■	If you are using the Simple Order API with XML, make sure you are using the correct API version for the features you are implementing. CyberSource recommends that you use the most recent API version.

For general information about the API versions, see Getting Started with CyberSource Advanced for the Simple Order API. The following table shows which Simple Order API version to use for the PayPal Express Checkout features.

 

Table 4

Choosing the Simple Order API Version

Feature	Simple Order API Version
Standard orders	Version 1.29 or later
Custom orders	Version 1.32 or later
Functionality introduced in May 2008: ■ Requesting the customer’s billing address ■ Using the invoice number, error code, and correlation ID fields	Version 1.36 or later
Billing agreements and reference transactions	Version 1.47 or later
Item-level request fields Note To enable item-level fields, contact CyberSource Customer Support to have your account configured for this feature.	Version 1.73 or later
Functionality introduced in October 2012: ■ Item-level reply fields for the Get Details service ■ Get Transaction Details service ■ Logo image field Note Contact CyberSource Customer Support to have your account configured for these features.	Version 1.77 or later

■	Set up your PayPal account.

When you open your PayPal business account, PayPal assigns you a PayPal account manager who helps you configure your PayPal account.

To set up your PayPal account:

Step 1

Log in to https://developer.paypal.com using your master Sandbox developer account.

To make testing easier, check the Log me in automatically box. This option makes it quicker for you to approve the test payments you process through the CyberSource and PayPal test environments.

Step 2

Click Accounts in the left pane to view your Sandbox Business and Buyer accounts.

Step 3

Set up or select an account.

■	To test PayPal Express Checkout transactions, you need to set up a personal test account and a business test account.

■	If you need to set up Business seller accounts from which to run test transactions, do so here.

■	If you already set up an account, select the Business or Premier account that you will use as your seller account, which is the account you set up with CyberSource as your PayPal merchant ID for receiving payments through CyberSource.

Step 4

Navigate to https://www.sandbox.paypal.com/signin/ in a new browser tab.

The PayPal web site displays a new window.

Step 5

In the new window, log in using your Sandbox seller account credentials.

Step 6

Choose the My Account tab and click Profile. The Profile Summary page is displayed.

Step 7

Click My selling tools in the left pane.

Step 8

In the Selling online section, click the Update link under API access.

Step 9

Click Add or Edit API Permissions link under Pre-built Payment Solution.

Step 10

Click Add New Third Party button on the Manage Third Party Access page.

Step 11

For testing, enter cybersource_paypal_api1.cybersource.com, which is the CyberSource API account username.

For live transactions, enter paypal_cybersource_api1.cybersource.com.

Step 12

Click Lookup.

Step 13

Check the following permissions:

■	Use Express Checkout to process payments.

■	Issue a refund for a specific transaction.

■	Authorize and capture your PayPal transactions.

■	Obtain information about a single transaction.

■	Search your transactions for items that match specific criteria and display the results.

■	Charge an existing customer based on a prior transaction.

■	Create and manage Recurring Payments.

■	Obtain authorization for pre-approved payments and initiate pre-approved transactions.

If you are going to use reference transactions, contact your PayPal representative to enable billing agreements and reference transactions.

Step 14

Click Add.

Step 15

To edit or view permissions, click the Edit Third Party button on the Manage Third Party Access page.

Step 16

You must provide the username of your Seller test account to CyberSource Customer Support to enable your account for Express Checkout.