Integration Guide

Table Of Contents
Express Checkout Integration Guide October 2009 83
Immediate Payment
Integrating Immediate Payment into the Express Checkout Flow
8
Buyers shipping address.
3. The SetExpressCheckout response returns a TOKEN.
4. The buyer is redirected to PayPal.
5. The buyer reviews their payment and clicks Continue.
6. Optionally, you may call GetExpressCheckoutDetails. The
GetExpressCheckoutDetails response returns information about the buyer.
7. In the call to DoExpressCheckoutPayment, you must pass the .
ALLOWEDPAYMENTMETHOD: This is the payment method type. For immediate payment,
the value is InstantPaymentOnly.
L_EBAYITEMCARTIDn: EBay provides you with this value.
At this time, PayPal checks the availability of the eBay item.
8. If the item is available and payment is successful, the DoExpressCheckoutPayment
response returns the eBay transaction ID (EBAYITEMAUCTIONTXNID).
Integrating Immediate Payment into the Express Checkout Flow
To integrate Immediate Payment into your Express Checkout flow, you add a few new fields to
SetExpressCheckout and DoExpressCheckoutPayment.
The Call to SetExpressCheckout
You must have Express Checkout integrated into your payment solution. It is recommended
that you sell one eBay item in a transaction or a quantity of the same item (considered a single
eBay listing).
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. Say, for example, you determine that the buyer has a mixed