Integration Guide

Table Of Contents
Express Checkout Integration Guide May 2010 129
Using Other PayPal API Operations
Handling Payment Review
12
NOTE: You must use version 58.0 to obtain the initial status information provided by
DoExpressCheckoutPayment, DoReferenceTransaction,
DoAuthorization, or DoReauthorization.
To use payment review with the DoExpressCheckoutPayment,
DoReferenceTransaction, DoAuthorization, and DoReauthorization PayPal API
operations, you must
1. Check the payment status in the response to the API operation; specifically, check whether
PaymentStatus is set to Pending.
2. If the PaymentStatus is set to Pending, check whether the PendingReason is set to
PaymentReview, because there are other reasons that a transaction may become pending.
For example, an unsettled authorization’s PaymentStatus is set to Pending; however,
its PendingReason is set to authorization, which is not related to payment review.
If PaymentStatus is set to Pending and the PendingReason is set to PaymentReview,
you should not ship merchandise or, in the case of electronic media, you should not allow
download access.
Because the payment status will change after review, you must periodically check the payment
status using the GetTransactionDetails API operation.
The following diagram shows how to use the payment status to detect payments under review
by PayPal.