Integration Guide
Table Of Contents
- Express Checkout Integration Guide
- Contents
- Preface
- Introducing Express Checkout
- Express Checkout Button and Logo Image Integration
- PayPal Name-Value Pair API Basics
- Implementing the Simplest Express Checkout Integration
- Testing an Express Checkout Integration
- Customizing Express Checkout
- Implementing the Instant Update API
- Immediate Payment
- Implementing Parallel Payments
- Handling Payment Settlements
- Handling Recurring Payments
- How Recurring Payments Work
- Recurring Payments Terms
- Options for Creating a Recurring Payments Profile
- Recurring Payments With Express Checkout
- Recurring Payments Profile Status
- Getting Recurring Payments Profile Information
- Modifying a Recurring Payments Profile
- Billing the Outstanding Amount of a Profile
- Recurring Payments Notifications
- Using Other PayPal API Operations
- Integrating giropay with Express Checkout
Using Other PayPal API Operations
Handling Payment Review
12
128 May 2010 Express Checkout Integration Guide
REFUNDTYPE=Partial
3. For a partial refund, specify the refund amount, including the currency.
AMT=amount
CURRENCYCODE=currencyID
4. For a partial refund, specify the memo description.
NOTE=description
5. Execute the RefundTransaction operation.
6. Check the acknowledgement status in the RefundTransaction response to ensure that
the operation was successful.
Handling Payment Review
Payment Review is an Express Checkout feature that identifies high-risk transactions and
notifies you so that you can hold shipments until the risk has been evaluated by PayPal. You
are immediately notified that a payment is under review and you should not ship merchandise
or, in the case of electronic media, you should not allow download access while the payment is
under review. You are notified of the resolution within 24 hours.
NOTE: Payment Review is not applicable to Direct Payment.
You can determine the status of a payment in the following ways:
z by logging into https://www.paypal.com/ and viewing the status information in the
Transaction History
z by email sent by PayPal
z by Instant Payment Notification (IPN) message
z by Payment Data Transfer (PDT) message
z by checking the status of a transaction programatically
Programatically, the merchant can determine the status of a payment by checking the initial
status of a transaction using any of the following the API operations:
z DoExpressCheckoutPayment
z DoReferenceTransaction
z DoAuthorization
z DoReauthorization
You can check the subsequent status of a transaction programatically by calling the
GetTransactionDetails API operation.