Cartridge DE_EPAGES::PayPalExpress

Purpose

This Cartridge enables merchants to use PayPal Express Checkout with epages shops. It creates a new feature "PayPal Express" and a payment type with the same name.

Prerequisites

getting started

Concepts

Extensions at basket page

Checkout and payment process

PayPal Express payment process flow

The image above shows the flow of the checkout process. When the customer presses the PayPal Express button, epages sends a request SetExpressCheckout to the PayPal API Server. Besides some other request parameter the total amount of the basket is sent to PayPal. This is the initial step to set up the checkout process. At PayPal side a token will be generated and passed to epages by the response. epages uses the token as an url parameter and redirect the customers browser to the Paypal payment page.

The user has to log in with his account data and there he will confirm a payment method and a shipping address. If he aborts the payment process at the PayPal page, he will be redirected from PayPal to the basket in the shop and he can continue with another checkout method. In case of confirmation epages uses another request GetExpressCheckoutDetails to get the customer details like shipping address and contact information. The token will be used as the request parameter. PayPal sends the requested details by response and the customer’s browser is redirected to the order confirmation page of the shop.

If the order is placed by the customer, epages starts the DoExpressCheckoutPayment request. Request parameters are the total amount of payment, the shipping address if the customer changed it at epages side, and the total amounts of items, tax, shipping and handling. With the response of the transaction results (success/failure) the transaction is finished.

From epages 6.10.2 on the name/value pair API is used instead of SOAP.