Benutzerhandbuch PayPal Standalone (Englisch)
Contents
1. 12 16 OXID eSales AG www oxid esales com info oxid esales com Version 3 1 0 User Manual OXID eshop Enterprise Edition HOME KITEBOARDING WAKEBOARDING GEAR MORE YOU APE HEPE WAKEBOARDING WAKEBOARDS WAKEBOARD GROOVE Bindings Sets TAGS suspenders straight sleeveless short Shirt pima longsleeve long sleeve liquid force Kuyichi kiteboarding kiteboard kite Jeans dark cool casual board anna 2010 More 1 tems in Cart Wakeboard GROOVE 329 00 329 00 Total CHECKOUT DISPLAY CART Tha sehet caver way de por Display cart in PayPal Wakeboard GROOVE I3 ANo 2103 XX XXX No ratings OEE A stylish wakeboard with a fabtastic performance RRP 390 00 4 329 00 GES The safer easier way to pay V Display cart in PayPal Low stock order quicky Delivery tine 4 6 weeks Figure 3 Product details page with mini cart OXID eSales AG www oxid esales com info oxid esales com Version 3 1 0 13 16 User Manual In both cases the user will be directed to the PayPal payment page According to the configuration and customer s approval the ordered products are shown on the PayPal payment page The customer can now login to his PayPal account or create a new account After payment confirmation the customer is redirected to the shop Pay with PayPal Pay with my PayPal account PayPal Your shopping cart Log in2. 5 Functional description 5 1 PayPal in the checkout process In the OXID eShop orders can be paid via PayPal With PayPal Basis PayPal can be selected as payment method during checkout step 3 At this time the user is already logged in to the shop or shopping without registration Hello John Doe X LOGOUT ACCOUNT EUR m OXID eshop Enterprise Edition HOME KITEBOARDING WAKEBOARDING GEAR MORE p YOU ARE HERE PAY Please select your shipping method Standard v Payment Method O Invoice Cash in advance Direct Debit Credit Card COD Cash on Delivery paypal PayPal When selecting this payment method you are being redirected to PayPal where you can login into your account or open a new account In PayPal you are able to authorize the payment As soon you have authorized the payment you are again redirected to our Shop where you can confirm your order Only after confirming the order transfer of money takes place Display cart in PayPal Figure 1 Checkout order step 3 When checking out with PayPal Express the buyer can complete the purchase from checkout step 1 the product details page or the mini cart 11 16 OXID eSales AG www oxid esales com info oxid esales com Version 3 1 0 User Manual LOGIN REGISTER ACCOUNT v EUR v HY OXID eShop Enterprise Edition HOME KITEBOARDING WAKEBOARDING GEAR MORE SEARCH JA YOU ARE HERE VIEW CART Figure 2 Checkout order step 1
3. the tmp folder of your shop 4 Configuration In order to enable PayPal payment for customers in the OXID eShop the related payment type needs to be configured In the module settings you can define how payment via PayPal is to be made in the OXID eShop Note If you previously used PayPal module 2 1 this installation prevents the settings to be copied from OXID eFire 4 1 Setting up PayPal payment method You can configure the payment method according to your needs Remember to set the payment method also in the settings for Shipping Methods Detailed information can be found under Documentation and help http www oxid esales com de support services dokumentation und hilfe oxid eshop einrichtung zahlungsarten html German language only With a standard installation of the shop PayPal can be set up in only two steps 8 16 OXID eSales AG www oxid esales com info oxid esales com Version 3 1 0 User Manual e Under Shop Settings gt Payment Methods at least the user group Domestic customer is assigned to PayPal payment e Under Shop Settings gt Shipping Methods PayPal payment is assigned to the respective shipping methods for example Standard Please define a standard shipping method for payments via PayPal This shipping method is required and used for customer orders placed via a mobile device You can find the corresponding option on the Main tab of Shipping Methods 4 2 Module settings Go to Exten
4. time of money transfer can be set You can choose between an immediate capture of the invoice amount a later capture shortly before or after the shipping of the products and the automatic selection between these two methods depending on the remaining stock defined e Amounts of orders paid via PayPal can be captured or refunded These may be split up in up to 10 partial amounts e An overview of the PayPal transactions is available for each order 5 16 OXID eSales AG www oxid esales com info oxid esales com Version 3 1 0 User Manual The module can be downloaded free of charge from OXID eXchange http exchange oxid esales com index php lang 0 amp cl search searchparam paypal 2 System requirements The system requirements given below apply to the PayPal module In addition the PayPal module only works if the OXID eShop was configured for SSL mode e PHP 5 3 or higher e CURL e OpenSSL To check the system requirements please proceed as follows e Copy the file check system requirements php into the root folder of your shop e Open the following URL in your browser www youroxideshop com check system requirements php Replace www youroxideshop com with the address of your shop e Inthe browser you can see whether the system requirements are met or further measures have to be taken Contact your web host in case not all requirements are fulfilled Note Remember to remove the test file after successful test
5. Pal history all transactions are shown in a summarize table For each transaction such as authorization capture refund or cancellation a line is created in the table at the end of which further details can be viewed by clicking on a small button The table lines for the capture of an amount have another button for refunds Thus the refund can be assigned exactly to an amount captured 15 16 OXID eSales AG www oxid esales com info oxid esales com Version 3 1 0 User Manual An additional table on the tab gives an overview of all ordered products including quantity product number product name price and VAT 6 Notes 6 1 Changes to the PayPal logo PayPal requires you to use the corresponding PayPal logos in your shop As long as you keep to PayPal s integration guidelines https www paypal com uk logos you can freely make changes to the logos 16 16 OXID eSales AG www oxid esales com info oxid esales com Version 3 1 0
6. User Manual OXID eSales Documentation PayPal Module User Manual OXID eSales AG www oxid esales com info oxid esales com Version 3 1 0 User Manual Copyright Copyright 2013 OXID eSales AG Germany Copying of this document or its contents in particular using texts or parts of text is subject to the explicit prior permission by OXID eSales AG The information provided in this document was prepared according to the current state of the art OXID eSales AG however will assume no liability or warranty for the timeliness correctness and completeness of the information provided Since errors despite all efforts cannot be ruled out entirely we always appreciate suggestions License Licensing of the software product depends on the shop edition used The software for OXID eShop Community Edition is published under the GNU General Public License v3 You may distribute and or modify this software according to the licensing terms published by the Free Software Foundation Legal licensing terms regarding the distribution of software being subject to GNU GPL can be found under http www gnu org licenses gpl html The software for OXID eShop Professional Edition and Enterprise Edition is released under commercial license OXID eSales AG has the sole rights to the software Decompiling the source code unauthorized copying as well as distribution to third parties is not permitted Infringement will be reported to the authoriti
7. al transactions SET shopid IF SELECT oxedition EE FROM oxshops LIMIT 1 1 oxbaseshop DELETE FROM oxtplblocks WHERE OXSHOPID shopid AND OXMODULE oepaypal e Runthe SQL statement by clicking the Start Update button e Enterprise Edition only In the admin panel clear the cache under Master Settings gt Core Settings gt Caching e Goto Shop Settings gt Payment Methods e Select the payment method PayPal and change the Purchase Price to O in the from field and 10000 in the to field e Delete the folder modules oe oepaypal e Goto the module management in the admin panel of the shop You will receive the message that the module folder for one registered module is missing When being asked whether to remove all module data click the Yes button 3 1 2 Module PayPal 3 0 If you have installed module PayPal 3 0 in your OXID eShop please proceed as follows e Go to Extensions gt Modules in the admin panel of the shop e Select the PayPal module and deactivate it e Delete the folder modules oe oepaypal e Goto the module management in the admin panel of the shop You will receive the message that the module folder for one registered module is missing When being asked whether to remove all module data click the Yes button 3 2 Copying module files Copy the contents of the copy_this folder into the root folder of you
8. aults as the payment request is verified and confirmed in real time Transactions will be carried out by one of the world s leading payment providers In Germany alone more than 12 million customers already use PayPal for safe online payments Module title PayPal Version 3 1 0 Pp P f Category OXID eFire Extension Payment in the online shop ay a Manufacturer OXID eSales AG Internet www oxid esales com E mail info oxid esales com The PayPal module was designed by OXID eSales in cooperation with PayPal Unlike with previous module versions no OXID eFire account is required from version 3 0 0 or higher The communication between the OXID eShop and PayPal is performed directly via the standalone module The source code of the module is not encrypted Depending on the shop edition used the license terms mentioned at the beginning of this user manual apply Overview of the module functions e The PayPal payment method can be configured for each shop thus allowing different settings for individual subshops when using the Enterprise Edition e PayPal payment method is offered during the checkout process e PayPal express checkout can be used from the shopping cart mini cart and product detail page e Onthe PayPal payment page the shop name or logo can be displayed e The contents of the shopping cart can be transferred to the PayPal payment page e The PayPal payment page can be customized in terms of cart area color e The
9. es and prosecuted without exception 2 16 OXID eSales AG www oxid esales com info oxid esales com Version 3 1 0 User Manual Conventions The following typographic conventions are used in this document Monospace font with grey background for user inputs source code and URLs Italic grey font for file names and paths Bold font for input fields and navigation steps Bold dark red font for warnings and important notes Legal Notice OXID eSales AG BertoldstraBe 48 79098 Freiburg Germany Phone 49 761 36889 O Fax 49 761 36889 29 Executive board Roland Fesenmayr chairman Andrea Seeger Supervisory board Michael Schlenk chairman Headquarters Freiburg Country court Freiburg i Brg Commercial register number HRB 701648 3 16 OXID eSales AG www oxid esales com info oxid esales com Version 3 1 0 User Manual Table of contents feros farum 2 MA O M 2 CONVE ss 3 Impressum begal Notice 312 x 9 a ia enh rena cna a B vind ceased T NEE EE ANENE E K 3 aEb Egegice c 4 1 INTO ducado todabia OE 5 2 haee 6 3 Installations isst ino Op di tata 6 3 1 Removing the Previous MOUSE A ci ete ea A Aaa date 7 Si Mod le PayPal 2 Ed ei 7 RE M d le PayPal 3 0 in EEEE E E ii a 7 3 2 COPYING mod le filesinin 7 3 3 Changing write permissions of modules oe oepaypal logs oocococcocccocnnnncnnnnnnnnnnnnncnnnnnncnnnnn
10. he goods Only ship goods when the PayPal status says Completed Furthermore the OXID eShop can select the time for the money transfer automatically AUTOMATIC This option is based on the stock of the ordered products and a defined remaining stock After an order is placed the stock of a product is checked whether it falls below the defined remaining stock In this case AUTH is selected for money transfer Otherwise SALE is set 4 2 5 API authorization In order to use PayPal as payment method in the OXID eShop an API authorization is required It will be granted by PayPal Login to your PayPal Business account and request the API credential in your profile After accepting the PayPal User Agreement you will receive your API username and password as well as a signature Enter this information here and add the e mail address used for PayPal 4 2 6 Development settings The PayPal Sandbox allows intensive testing of the PayPal payment when building the online shop It provides a test environment within which transactions via PayPal are simulated No real payments are triggered Detailed information can be found in the PayPal Integration Center https cms paypal com uk cgi bin cmd render content amp content ID developer howto testing sandbox In case of problems PayPal logging can be activated for extensive troubleshooting 10 16 OXID eSales AG www oxid esales com info oxid esales com Version 3 1 0 User Manual
11. ing 3 Installation In this chapter the installation of the PayPal module for the OXID eShop versions 4 8 0 5 1 0 is described Follow this guide step by step In a new installed shop PayPal is already integrated You can skip this section The PayPal module has to be simply activated Therefor go to Extensions gt Modules in the admin panel of the shop In the Overview tab of the module click the Activate button For contract partners OXID eSales can carry out the installation of the module Besides the module installation the service Die Online Bezahlmethode f r OXID eShop PayPal provides you with additional features Further information and a service request form can be found on the OXID eSales website under http www oxid esales com de support services services html German language only 6 16 OXID eSales AG www oxid esales com info oxid esales com Version 3 1 0 User Manual 3 1 Removing the previous module 3 1 1 Module PayPal 2 1 If you have already used one of the PayPal module versions 2 1 in your OXID eShop and want to update the installed module you first have to uninstall the current module Backup your shop and database before updating to the new version e Go to Extensions gt Modules in the admin panel of the shop e Select the PayPal module and deactivate it e Switch to Service gt Tools e Copy the following SQL statement in the Update SQL field DROP TABLE IF EXISTS oepayp
12. nnnnnnnncnannnoss 7 3 4 Preparing templates aaa 8 3 5 Activating the modulessii ee xni ca dede audae it ee uds et trt ta tates 8 3 6 Deleting temporary tl a Pea sarete Pe oec eme viet suce oe ice eu ce tu nece eee eee nw Dee De Ue iaa 8 Een m NE 8 4 1 Setting up PayPal payment method 20 nennen hehe rennen ne heme re sese re serere serere nenne 8 4 2 Module SCLIN S e 9 42 1 PayPalimteGratiomciss raicsatets tetas an 9 4 2 2 Display on PayPal payment PaQe ade 9 4 2 3 Shopping cart on PayPal payment Page cceceeseeeeees eee eens ano cnn rra cnn crac 9 eua c r emp 10 4 2 5 API AUtHOFIZAtOM M 10 4 2 6 Development SENS ii aci 10 5 Functional descripta O A A AA E 11 5 1 PayPal in the Checkout prOCess iii is 11 5 2 PayPal o a 15 6 NOES incor OA AOS AAA LANA 16 6 1 Changes to the PayPal 09 O siii atenta dle lis p nautis Kali gelu oninia eletti 16 4 16 OXID eSales AG www oxid esales com info oxid esales com Version 3 1 0 User Manual 1 Introduction The PayPal module integrates the fast and secure payment via PayPal in the OXID eShop This allows the customer to pay the order by using the payment and address information of his PayPal account without the necessity of entering the information in the shop On the other hand shop operators are protected against payment def
13. on ID 1VU93067R5964670D Money capture Capture Authorization Void Re authorize PayPal history Date Action Amount PayPal status 7 Actions 2013 10 11 11 10 53 authorization 28 85 eur Pending E Note In case of error please see Details for more information Add Note Start Help Figure 5 Orders PayPal tab The payment information shows the payment status the total amount of the order and amounts that were captured canceled or refunded In case of delayed capture of an order amount AUTH up to 10 captures can be made within a period of 29 days This allows you to react flexibly if for example only parts of an order can be fulfilled at a given time In this case we recommend capturing the first partial deliver immediately after the order is completed and authorization is made Then wait until all remaining items of the order are available for shipment Reauthorize for the remaining amount and capture it With a click on the Capture mini button the total amount or partial amounts can be captured from the customer account This process can be documented by a comment A granted authorization for capture can be canceled and a payment status can be set The payment status can be Completed Pending or Canceled Also here it is possible to document for example the reason for the cancellation by a comment The Re authorize button can be used once for the above mentioned case of partial shipments In the Pay
14. r shop 3 3 Changing write permissions of modules oe oepaypal logs Change the write permission of modules oe oepaypal logs Grant full write permission for owner group and public 755 or 777 7 16 OXID eSales AG www oxid esales com info oxid esales com Version 3 1 0 User Manual 3 4 Preparing templates Additional files required for the use of the module in the shop can be found in the changed_full folder The subfolder changed_full modules contains standard module files as well as block files used for the Azure theme When installing the module in a shop without customized templates and files you can copy all files from this folder directly to the shop Generally and in particular in the case of a customized shop you need to compare old and new templates and files and adopt recent changes The changes made are documented in the following folders e templ_docu_admin changes in modules oe oepaypal out admin e templ_docu_blocks changes in modules oe oepaypal out blocks The folders containing the template documentation are only available in the installation package if changes were made in the respective templates and files no folders in the installation package of PayPal 3 1 0 3 5 Activating the module The PayPal module has to be activated in the shop In the Overview tab of the module click the Activate button 3 6 Deleting temporary files Delete all files and folders except for htaccess from
15. should have a maximum size of 190x60 px width x height and be located in the out theme img folder For each theme used the relevant file has to be in the corresponding folder The shop logo can be the standard logo used for the shop It is defined in the config inc php configuration file by the sShopLogo parameter However you may also have a custom shop logo displayed on the PayPal payment page the file name of which is to be entered here 4 2 3 Shopping cart on PayPal payment page Items in the shopping cart can be viewed on the PayPal payment page including product name number and price This is a basic setting which the customer however needs to confirm at checkout Further it can be set whether the customer has to check this option or the view of the shopping cart on the PayPal 9 16 OXID eSales AG www oxid esales com info oxid esales com Version 3 1 0 User Manual payment page shall be activated by default We recommend to have the shopping cart transferred to the PayPal payment page and to set the option that customer s confirmation is enabled by default 4 2 4 Capture Basically there are two ways to set the time for capture PayPal can either process the capture from the customer s account immediately at purchase SALE or verify the customer s account at purchase and authorize the transaction AUTH Within a period of 29 days the shop operator can manually capture the reserved amount e g before shipping t
16. sions gt Modules in the admin panel of the shop and select the PayPal module In the Settings tab the module can be configured Help texts are available for the individual settings 4 2 1 PayPal integration In this section you can find several settings for integrating the PayPal payment into the OXID eShop With PayPal Basis activated the PayPal payment method will be offered at the end of the checkout process If the customer selects this payment method he confirms the purchase on the PayPal payment page and will be subsequently redirected to the shop PayPal Express allows the customer to go directly to the PayPal payment page in the first step of the checkout flow There the buyer confirms the purchase and will then be redirected to the shop The shop receives all customer information relevant for the purchase from PayPal The PayPal Express button can also be enabled for the mini cart and the product details page 4 2 2 Display on PayPal payment page Enter here the name of the shop to appear on the PayPal payment page By entering the hexadecimal code you can define the cart area gradient color on the PayPal payment page It is set according to the RRGGBB model Example For the cart area color darkblue enter 000088 Information on the hexadecimal color code can be found under http en wikipedia org wiki Hexadecimal color Another setting allows the display of the shop logo instead of its name on the PayPal payment page The image
17. to your account to pay Paws ls Amount Email address Wakeboard GROOVE 329 00 PayPal password Forgot email or password With direct debit or credit card And pay wth your debt or credt card Cancel and return to OXID eShop Figure 4 PayPal payment page In case of express order also the customer s information from the PayPal account is provided to the shop Thus the form in checkout step 2 does not need to be filled out Since also the shipping method can be selected on the PayPal payment page the checkout process jumps directly to step 4 After checkout is completed the payment is arranged Depending on the configuration the amount is either transferred immediately between the PayPal accounts or the payment is authorized The authorized amount will be captured manually at a later time 14 16 OXID eSales AG www oxid esales com info oxid esales com Version 3 1 0 User Manual 5 2 PayPal for orders If products have been paid via PayPal payment information a PayPal history and an overview of the ordered products will be shown on the PayPal tab of the order in the admin panel Overview Main Addresses Products History Downloads PayPal Ordered products CR e pues a Quantity Prod No Title Gross Total VAT e x 1 71 Ti 4 4 9 19 Captured amount 0 00 EUR 3788 ransportcontainer 24 95 eur 24 95 eur Refunded amount 0 00 EUR Resulting payment amount 0 00 EUR Voided amount 0 00 EUR Authorizati
Download Pdf Manuals
Related Search