Integration Guide
Table Of Contents
- Website Payments Pro Integration Guide
- Contents
- Preface
- Introducing Website Payments Pro
- Introducing Direct Payment
- 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
- Handling Payment Settlements
- Handling Recurring Payments
- How Recurring Payments Work
- Recurring Payments Terms
- Recurring Payments With Express Checkout
- Recurring Payments With Direct Payments
- 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
- Using Other PayPal API Operations
- Integrating giropay with Express Checkout
Introducing Direct Payment
Additional Recommendations for Checkout With Direct Payment
2
14 October 2009 Website Payments Pro Integration Guide
– Credit card CVV value
– Cardholder first and last name
– Cardholder billing address
NOTE: You must also retrieve the IP address of customer's browser and include this with
the request.
2. When your customer clicks the Pay button, invoke the DoDirectPayment API operation.
3. The PayPal API server executes the request and returns a response.
– Ack code (Success, SuccessWithWarning, or Failure)
– Amount of the transaction
– AVS response code
– CVV response code
– PayPal transaction ID
– Error codes and messages (if any)
– Correlation ID (unique identifier for the API call)
4. If the operation is successful, you should send your customer to an order confirmation
page.
The Ack code determines whether the operation is a success. If successful, you should
display a message on the order confirmation page.
If not successful, which is either a failure or a success with warning due to Fraud
Management Filters, you should display information related to the error. In addition, you
may want to provide your customer an opportunity to pay using a different payment
method.
Additional Recommendations for Checkout With Direct Payment
Your checkout pages must collect all the information you need to create the
DoDirectPayment request. The following recommendations make it easier for your
customers to provide the needed information and aid in the correct processing of the request:
z Provide a drop-down menu for the “state” or “province” fields. For US addresses, the state
must be two letters, and must be a valid two-letter state, military location, or US territory.
For Canada, the province must be a two-letter Canadian province.
z Ensure customers can enter the correct number of digits for the CVV code. The value is 3
digits for Visa, MasterCard, and Discover. The value is 4 digits for American Express.
z Show information on the checkout page that explains what CVV is, and where to find it on
the card.
z Configure timeout settings to allow for the fact that the DoDirectPayment API operation
can take up to 30 seconds. Consider displaying a “processing transaction” message to your
customer and disabling the Pay button until the transaction finishes.