Integration Guide
Table Of Contents
- PayPal Payments Pro Integration Guide
- Contents
- Preface
- Introducing PayPal Payments Pro
- Introducing Direct Payment
- Introducing Express Checkout
- Getting Started With Direct Payment
- Getting Started With Express Checkout
- Integrating Recurring Payments
- How Recurring Payments Work
- Recurring Payments Terms
- Recurring Payments With Direct Payment
- Recurring Payments With the Express Checkout API
- Options for Creating a Recurring Payments Profile
- Recurring Payments Profile Status
- Getting Recurring Payments Profile Information
- Modifying a Recurring Payments Profile
- Billing the Outstanding Amount of a Profile
- Recurring Payments Notifications
- Getting Started With the PayPal Name-Value Pair API
- Implementing 3-D Secure Transactions (UK Only)
Implementing 3-D Secure Transactions (UK Only)
Examples
B
94 April 2012 PayPal Payments Pro Integration Guide
Examples
The following examples outline the transaction process for three basic situations.
Example 1: Successful 3-D Secure Authentication
In this example, the cardholder’s issuer uses 3-D Secure and the authentication is successful:
1. Construct your message for cmpi_lookup.
2. Review the response from cmpi_lookup. Ensure that all of the following are true:
– ErrorNo=0
– Enrolled=Y
– ACSUrl has content; for example:
<ACSUrl>https://www.somewebsite.com/acs</ACSUrl>
3. Using HTTP Form POST, redirect the cardholder to the issuer’s URL that was provided in
ACSUrl. Ensure that the PaReq has the data from the field PayLoad, from the
cmpi_lookup response.
4. Send the response (redirect) from the issuer’s HTTP Form POST to Cardinal using the
cmpi_authenticate message to determine how to proceed with the transaction.
5. The cmpi_authenticate response will specify how to proceed. To continue with
authorization, the following must be true:
– SignatureVerification=Y
– PAResStatus=Y, U, or A
6. Authoress as normal, with the additional fields described in 3-D Secure Fields for Direct
Payment Transaction Requests.
Example 2: 3-D Secure with Unsuccessful Authentication
In this example, the cardholder's issuer uses 3-D Secure and the authentication is not
successful:
1. Construct your message for cmpi_lookup.
2. Review the response from cmpi_lookup. Ensure that all of the following are true:
– ErrorNo is 0
– Enrolled is Y
– ACSUrl has content; for example:
<ACSUrl>https://www.somewebsite.com/acs</ACSUrl>