Advanced Features Guide

Express Checkout Advanced Features Guide April 2012 103
Immediate Payment
Integrating Immediate Payment for Third-Party Checkout
10
3. The SetExpressCheckout response returns a TOKEN.
4. The buyer is redirected to PayPal.
5. The buyer reviews their payment and clicks Continue.
6. (Optional) Call GetExpressCheckoutDetails. The GetExpressCheckoutDetails
response returns information about the buyer.
7. In the call to DoExpressCheckoutPayment, you must pass:
– PAYMENTREQUEST_
n_ALLOWEDPAYMENTMETHOD: This is the payment method type.
For immediate payment, the value is InstantPaymentOnly.
– L_PAYMENTREQUEST_
n_EBAYITEMCARTIDm: 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
(PAYMENTREQUEST_
n_EBAYITEMAUCTIONTXNID).
Integrating Immediate Payment for Third-Party Checkout
To integrate Immediate Payment for third-party checkout into your Express Checkout
implementation, you add a few new fields to SetExpressCheckout and
DoExpressCheckoutPayment.
The Call to SetExpressCheckout
You must have Express Checkout integrated into your payment solution. PayPal recommends
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 PAYMENTREQUEST_
n_ALLOWEDPAYMENTMETHOD to InstantPaymentOnly.
This blocks all pending funding sources and transactions in a pending state.
2. Pass BUYERUSERNAME and L_PAYMENTREQUEST_
n_EBAYITEMCARTIDm.
3. Set CHANNELTYPE to eBayItem.
4. Set L_PAYMENTREQUEST_
n_EBAYITEMNUMBERm to the number of the eBay item.
5. Specify the buyer’s shipping address.
6. Be prepared to handle Immediate Payment errors.