diff --git a/ecommerce/shopper_experience/paypal.rst b/ecommerce/shopper_experience/paypal.rst new file mode 100644 index 000000000..a3f0c1c3b --- /dev/null +++ b/ecommerce/shopper_experience/paypal.rst @@ -0,0 +1,54 @@ +=================================== +How to collect payments with Paypal +=================================== + +Paypal is the easiest payment method to configure. It is also the only one without any subscription +free. + +Setup your Paypal account +========================= + +1. Create a business account at Paypal.com (see: +https://www.paypal.com/in/cgi-bin/webscr?cmd=xpt/Marketing/general/how-to-set-up-a-paypal-account-outside) +or upgrade your account to Business account (merchant) if you have a basic account. + +2. Log in to your account at Paypal.com and go to +:menuselection:`My Account --> Profile --> My Selling Tools`. There click *PayPal button language +encoding* under *More Selling Tools* section. Then, click *More Options* and replace the two default +encoding formats by *UTF-8*. + +3. Open Paypal setup form in Odoo and enter your *Email ID*. + +4. The Paypal Merchant ID is not mandatory (extra verification level). It is provided in +Paypal under :menuselection:`My Account --> Overview`. + +5. Configure the IPN feedback (Paypal contacting your Odoo instance without needing the +redirection). The setting can be found in +:menuselection:`Profile --> My Selling Tools --> Instant payment notification`. +Activate it and set it to /payment/paypal/ipn. + +6. To test the workflow, you can create sandbox accounts by logging in at +https://developer.paypal.com/webapps/developer/applications/myapps with the same Paypal credentials. +Two default sandbox accounts are automatically generated when you register to Paypal: +one is a buyer, the other is a shopper. + +7. Log in with your buyer sandbox account to https://www.sandbox.paypal.com (same password than real +account) and apply the same format change. + +.. tip:: + To automatically redirect your customers when the payment is completed, go to your Website + Preferences and turn *Auto Return* on. Set *Return URL* to /shop/confirmation. + Verify that your *Notify URL* uses the correct protocol (HTTP/HTTPS). + +.. tip:: + If you want your customers to pay without creating a Paypal account, *Paypal Account + Optional* needs to be turned on. + +Transaction fees +================ + +You can charge an extra to the customer to cover the transaction fees Paypal charges you. +Once redirected to Paypal, your customer sees an extra applied to the order amount. + +To activate this, go to the *Configuration* tab and check *Add Extra Fees*. Default +fees are the ones charged by Paypal.