Advanced Features Guide

Immediate Payment
About Immediate Payment For Express Checkout
10
104 April 2012 Express Checkout Advanced Features Guide
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 only 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 PAYMENTREQUEST_
n_ALLOWEDPAYMENTMETHOD to InstantPaymentOnly.
This blocks all pending funding sources and transactions in a pending state.
2. Pass the L_PAYMENTREQUEST_
n_EBAYITEMCARTIDm.
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. For example, you determine that the buyer has a mixed
cart of eBay and non-eBay items. To allow the buyer to check out only 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 (PAYMENTREQUEST_
n_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.
Immediate Payment for Express Checkout has the following caveats:
 By design, it does not support non-instant funds, such as Electronic Funds Transfer,
eCheck, or ELV.
 It is open for use by all merchants, whether or not they are selling on eBay.
 Sale is the only payment action supported.