Integration Guide

Table Of Contents
Immediate Payment
About Immediate Payment For Express Checkout
8
94 May 2010 Express Checkout Integration Guide
To integrate Immediate Payment into the SetExpressCheckout call:
1. Set ALLOWEDPAYMENTMETHODTYPE to InstantPaymentOnly.
This blocks all pending funding sources and transactions that end up in a pending state.
2. Pass BUYERUSERNAME and L_EBAYITEMCARTIDn.
3. Set CHANNELTYPE to eBayItem.
4. Set L_EBAYITEMNUMBERn to the number of the eBay item.
5. Specify the buyers shipping address.
6. Be prepared to handle Immediate Payment errors.
For errors you choose to handle, you need to send the buyer error messages appropriate to the
situations generating the errors. For example, a buyer may have a mixed cart of eBay and non-
eBay items.To allow the buyer to check out just the non-Immediate Payment items, you must
provide an appropriate message to the buyer, remove the Immediate Payment item, and retry
the transaction.
The Call to DoExpressCheckoutPayment
To integrate Immediate Payment into the DoExpressCheckoutPayment call:
1. Set ALLOWEDPAYMENTMETHODTYPE to InstantPaymentOnly.
This blocks all pending funding sources and transactions that end up in a pending state.
2. Pass the L_EBAYITEMCARTIDn.
3. Be prepared to handle Immediate Payment errors.
For errors you choose to handle, you need to send the buyer error messages appropriate to
the situations generating the errors. Say, for example, you determine that the buyer has a
mixed cart of eBay and non-eBay items. To allow the buyer to check out just the non-
Immediate Payment items, you must provide an appropriate message to the buyer, remove
the Immediate Payment item, and retry the transaction.
If payment is successful, the DoExpressCheckoutPayment response returns the eBay
transaction ID (EBAYITEMAUCTIONTXNID).
About Immediate Payment For Express Checkout
Immediate Payment for Express Checkout ensures the buyer pays for purchases at the time the
buyer commits. This application is available to any merchant integrating Express Checkout.
NOTE: This feature is available with API version 63.0 and higher.