Cartridge DE_EPAGES::PayPalPro
PURPOSE
This Cartridge enables merchants to use PayPal Pro with epages shops. It creates a new feature "PayPalPro" and a payment type with the same name.
If merchants use this payment type in their shops they can do an online credit card payment which does not require the customer to leave the shop storefront.
PREREQUSITES
- It requires epages 6.10 at least.
- PayPal Pro works completely on internal test servers, except when using 3Dsecure.
- All application server machines must be directly connected to the Internet. Proxy servers are not supported.
- For doing transactions you need a PayPal Pro merchant account. It can be created online.
- For using 3Dsecure you need a cardinal account as well.
GETTING STARTED
Linux
-
Logon as ep_appl and load epages environment:
su ep_appl
. /etc/default/epages6
-
Install and register the PayPalPro cartridge in the store you want to use it for:
cd $EPAGES_CARTRIDGES/DE_EPAGES/PayPalPro
$PERL Makefile.PL
make install STORE=Store
make register
$PERL $EPAGES_CARTRIDGES/DE_EPAGES/ShopConfiguration/Scripts/synccartridges.pl -storename Store
-
Test if the installation was successful:
cd $EPAGES_CARTRIDGES/epages/PayPalPro
make test STORE=Store
- Continue with the points in the All OS section.
Windows
All OS
- Login to PBO and assign the PayPalPro feature to the shop type you want to use PayPal Pro for.
- Login to the MBO of a shop that has the PayPalPro feature assigned. Go to Settings - Delivery and Payment - Payment Methods.
- Create a payment method of payment type PayPalPro. Click on the payment method and choose the Settings tab.
- If you do not have a PayPal Pro merchant account yet, create one at the websites described above.
- Enter user, vendor, partner, password, and the cardinal credentials of your PayPalPro merchant account, choose test or live mode.
- Choose the General tab and make the payment method visible.
- Go to the shop's storefront and add a product to the basket. You should now see the PayPal Pro paymentmethod in the payment select box on the basket page.
- Start the checkout process. At the end you will be asked to enter your credit card details.
- After doing a successful transaction, you see a transaction in the shop's MBO, under Orders - Transactions - PayPal Pro.
CONCEPTS
-
If the merchant chooses transaction type authorise he can capture the amount later on the transactions list page.
-
Payments can be done on both baskets and orders, that means before or after the order is created. The Perl module
UI/BasketOrder.pm
contains common stuff and is the base package for both UI/Basket.pm
and UI/Order.pm
.