Express Checkout Integration Overview DEVELOPER DOCUMENTATION Document edition: v.
Contents Getting Started with PayPal .................................................................................... 3 What is Express Checkout?.................................................................................. 3 How Express Checkout Works .............................................................................. 3 Designing an Optimal Checkout Flow .................................................................... 5 Integration Use Cases..........................................
Express Checkout ~ Integration Overview Getting Started with PayPal This guide provides you with the basic information and best practices guidelines you will need to integrate Express Checkout on your website. It is intended for you, the merchant, to help you create an online shopping experience that can increase sales and customer loyalty by building a checkout process that is fast, easy and intuitive. For comprehensive integration information, see the Express Checkout Integration Guide.
Express Checkout ~ Integration Overview Express Checkout API Calls Backend Flow The following diagram shows the Express Checkout API operations that are called during a typical payment transaction. For integration details, see Use case 1: A Sale transaction.
Express Checkout ~ Integration Overview Designing an Optimal Checkout Flow PayPal has identified specific elements which can help you optimize the checkout experience and get the most out of using Express Checkout. These elements were identified through years of A/B testing, industry research and qualitative studies with merchants and buyers. Implementing these guidelines can: Result in higher sales conversions. Create an online shopping experience that can increase sales and customer loyalty.
Express Checkout ~ Integration Overview 2. Add a PayPal Express Checkout Shortcut to the Shopping cart page to the right or left, top or bottom of your checkout button. The Checkout with PayPal button should: Always be clickable. Be placed right below or next to your own cart's checkout button. Appear before your website collects any billing or shipping details, and before any other payment. Be aligned vertically or horizontally with your own checkout button. Include a What is PayPal? link.
Express Checkout ~ Integration Overview After receiving the SetExpressCheckout API response, redirect the customer to PayPal. 3. Show PayPal as a payment option near the other payment options on your Payment Methods page. Adding a PayPal radio button to your existing payment choices helps buyers read and understand the payment options in a clearer way. 4. Provide a What is PayPal? link when using any PayPal banner, button or placement.
Express Checkout ~ Integration Overview server so that your buyer's web browser does not display a message that the payment page contains non-secure items. 6. Pass line item details to PayPal, including the breakdown of items and total purchase costs. Passing line item details also helps create a seamless transition from your site to the PayPal checkout flows and makes buyers feel more confident in their transactions because they can see their purchase details from start to end. 7.
Express Checkout ~ Integration Overview 1. Pass your store logo and store name to PayPal to display. 2. Pass full line item details, including the breakdown of items and total costs. 3. Customize colors to match your website. 4. Pre-populate billing fields with any customer information your website collects. Integration Use Cases Implementing Express Checkout requires you to set up a PayPal button and call the appropriate API's for the type of payments you want to offer.
Express Checkout ~ Integration Overview create a button, copy the button HTML code to your website. 2. Offer PayPal as a payment choice on your payment options page using radio buttons. You can find html code to copy and paste on your site here. 3. Include the words "What is PayPal?" next to the Express Checkout Shortcut Button, next to the PayPal Mark on your payment options page, and next to any PayPal banners or messaging. You can find the html code to copy and paste on your site here.
Express Checkout ~ Integration Overview PayPal page flow and the options available to buyers. You should start by setting up a standard Express Checkout transaction, which can be modified to include additional options. To set up the simplest standard Express Checkout transaction: Specify the amount of the transaction; include the currency if it is not in US dollars. Specify the total amount of the transaction if it is known; otherwise, specify the subtotal.
Express Checkout ~ Integration Overview Although the default payment action is a Sale, it is a best practice to explicitly specify the payment action as one of the following values: PAYMENTREQUEST_0_PAYMENTACTION=Sale PAYMENTREQUEST_0_PAYMENTACTION=Authorization PAYMENTREQUEST_0_PAYMENTACTION=Order Execute the SetExpressCheckout API operation to set up the Express Checkout transaction. Test that the response to the SetExpressCheckout API operation was successful (ACK=Success).
Express Checkout ~ Integration Overview NOTE: Only populated fields are returned in the response. Completing the Express Checkout Transaction To complete an Express Checkout transaction, you must invoke the DoExpressCheckoutPayment API operation. NOTE: This example assumes that PayPal redirects the buyer's browser to your website with a valid token after you call the SetExpressCheckout API. Optionally, you may call the GetExpressCheckoutDetails API before calling the DoExpressCheckoutPayment API.
Express Checkout ~ Integration Overview Regardless of the specified currency, the format for most currencies must include a decimal point with exactly two digits to the right and an optional thousands separator to the left, which must be a comma. For example, EUR 2.000,00 must be specified as 2000.00 or 2,000.00. The specified amount cannot exceed USD $10,000.00, regardless of the currency used. NOTE: Some currencies such as Yen do not support decimal points.
Express Checkout ~ Integration Overview The buyer goes to your website and adds the item to his/her cart and checks out via PayPal Express Checkout. You set the PAYMENTACTION to Authorization in both the SetExpressCheckout and DoExpressCheckoutPayment API calls. You get back an Authorization ID. The transaction is successful thus far. Wednesday: You go to ship the product. But before it ships, you capture the payment by making a DoCapture API call.
Express Checkout ~ Integration Overview The net amount of the refund, which is deducted from your balance. To issue a refund: In the RefundTransaction request, specify the transaction ID of the original transaction which you want to refund. TRANSACTIONID=transaction_id Specify the kind of refund, which is either Full or Partial. REFUNDTYPE=Full Or REFUNDTYPE=Partial For a partial refund, specify the refund amount, including the currency.
Express Checkout ~ Integration Overview NOTE: The PayPal developer site automatically creates Sandbox credentials for you when you log in with your PayPal account for the first time to https://developer.paypal.com. Going Live With Your Express Checkout Integration 1. After you have tested your application with the PayPal Sandbox, and you are ready to move it to production, use the following checklist to ensure you are not forgetting any steps for going live.
Express Checkout ~ Integration Overview Express Checkout Sample Code Use the following table to view sample code for each of the three API calls needed for Express Checkout: API Call SetExpressCheckout Sample Code PHP Java .NET GetExpressCheckoutDetails PHP Java .NET DoExpressCheckoutPayment PHP Java .NET For SDK information, see the Merchant API SDK.
