Integration Guide
Table Of Contents
- Express Checkout Integration Guide
- Contents
- Preface
- Introducing Express Checkout
- Express Checkout Button and Logo Image Integration
- PayPal Name-Value Pair API Basics
- Implementing the Simplest Express Checkout Integration
- Testing an Express Checkout Integration
- Customizing Express Checkout
- Implementing the Instant Update API
- Immediate Payment
- Implementing Parallel Payments
- Handling Payment Settlements
- Handling Recurring Payments
- How Recurring Payments Work
- Recurring Payments Terms
- Options for Creating a Recurring Payments Profile
- Recurring Payments With Express Checkout
- Recurring Payments Profile Status
- Getting Recurring Payments Profile Information
- Modifying a Recurring Payments Profile
- Billing the Outstanding Amount of a Profile
- Recurring Payments Notifications
- Using Other PayPal API Operations
- Integrating giropay with Express Checkout
Express Checkout Integration Guide May 2010 103
Implementing Parallel Payments
Integrating Parallel Payments Using the SOAP API
9
Response Parameters
[successResponseFields]
&TOKEN=EC-17C76533PL706494P
Integrating Parallel Payments Using the SOAP API
Parallel payments uses the PaymentDetailsType structure to pass data for each merchant
receiving payment. You can pass up to a 10 structures in a single call to
SetExpressCheckout and DoExpressCheckoutPayment.
NOTE: Be sure to use structure fields that are not marked as ‘deprecated’ in the SOAP API
reference documentation.
To integrate parallel payments using the SOAP interface to Express Checkout:
1. Create PaymentDetails as an array of PaymentDetailsType structures, one for each
payment you will be hosting on your marketplace.
2. You are required to pass values in the following PaymentDetailsType fields in the call
to SetExpressCheckout and DoExpressCheckoutPayment.
– Pass the value Order in PaymentAction.
– Pass a unique value in PaymentRequestID. You will use this value to locate the
matching response details for that payment.
– Pass the merchant’s Payer Id (secure merchant account Id) or the merchant’s email
address in the SellerDetailsType.PayPalAccountId field.
3. Use PaymentDetailsType and PaymentDetailsItemType fields, as appropriate, in
the call to SetExpressCheckout and DoExpressCheckoutPayment to pass data
about each payment.
Result:
For each payment in the transaction, the DoExpressCheckoutPayment response returns a
PaymentInfoType structure corresponding to each payment:
z The PaymentRequestID will match the value you passed in the
DoExpressCheckoutPayment request. Use this value to locate the response data for
each payment.
z SellerDetailsType.PayPalAccountId returns one of the following values that was
passed in:
– The merchant’s email address
– The merchant’s Payer Id (secure merchant account Id)