PayPal is a well-recognized payment system. By enabling it, you’ll give your users another reason to build trust towards your website. In this page we will show you how to receive payments via PayPal and handling them in Axerve Ecommerce Solutions. PayPal works in 200+ countries.
If you want to use the paymentType tag for this method, the value to use is PAYPAL. See the section How to redirect the customer to a payment method to learn how to use the paymentType tag.
If PayPal is the only option set, The user will be redirected directly, without seeing the Axerve Ecommerce Solutions payment page.
PayPal will show as one of the available options at checkout:
You can try PayPal in the Axerve Ecommerce Solutions test environment. To do so, you must create a sandbox business account.
A sandbox account is almost the same thing of a real account, with the important difference that no money is involved. You can create test accounts for buyers and for merchants, so that you can experiment with payments (e.g. try a buyer with no money, or a different currency…).
Sandboxed accounts can be only used with sandboxed paypal payment pages. When setting a paypal account in Axerve Ecommerce Solutions, the payment will be automatically redirected to the sandboxed payment page.
To create and manage sanboxed accounts, go to PayPal Sandbox and create a new sandbox account.
If you select your country before registering, your account will be already set to accept the Euro currency.
PayPal’s website might change during time, and the page can be different based on language and country; the steps are as follows:
A standard business account (free) is sufficient.
Fill in the required data, like the email address, your name, etc.
Then, repeat the same steps to create a Personal Sandbox account. This will be used as a test buyer.
You can put a non-valid email address, as long as you remember it. These are valid only in PayPal sandbox.
If your e-mail is user@email.com, we suggest you to create the accounts user-merchant@email.com and user-buyer@email.com.
Once you have created a sandbox paypal merchant account, go to your account settings:
PayPal’s user interface may change over time. Links and menus may change location or graphic style.
Click on Account access and then, under API access, click on Update.
Then, click on Grant Api permission and insert the value bsitecomm-facilitator_api1.sella.it. Then click Lookup. Add all permissions, then Add.
The next step on PayPal’s website is to set up Instant payment notifications.
Go back to your account settings. Click on Notifications and then, under Instant payment notifications, click on Update.
In Notification URL type https://sandbox.gestpay.net/pagam/PayPalIPN.aspx, then select Receive IPN messages and click Save.
PayPal sandbox account may be using a different currency, so it might be useful to check and adjust accordingly. To do this, click on Money, banks and cards in your account settings and navigate to the Currency management section. From here, you can add new currencies.
Contact Axerve’s customer support at ecommerce@sella.it and ask them to link your sandbox business account (in our example, gestpay-merchant@gmail.com) with your Axerve Ecommerce Solutions test account.
Only sandbox buyer accounts can pay on sandbox merchant accounts.
If you try to carry out a payment, you will be able to see PayPal in the payment options:
Remember to use the sandbox buyer account:
Congratulations, You have made it!
Now that you’ve done your tests with Axerve Ecommerce Solutions Test Environment and PayPal Sandbox, you can enable the official PayPal account with your official Axerve Ecommerce Solutions account.
Enabling PayPal with Axerve Ecommerce Solutions requires the following steps:
Click on Join now! in the Merchant’s Home Page
Configure PayPal and Axerve Ecommerce Solutions to work together setting the API Access
Set the IPN settings
Send documents to PayPal to remove limits
In your Merchant Back Office home page you’ll see the button Join Us! (Aderisci Ora, in italian):
This will guide you through the process of enabling PayPal with Axerve Ecommerce Solutions.
If you already have an active PayPal account, you can link it to Axerve Ecommerce Solutions, otherwise it can be a newly created account.
Click on Account access and then, under API access, click on Update.
Then, click on Grant Api permission and insert the value ecommerce_api1.sella.it. Then click Lookup. Add all permissions, then Add.
The next step on PayPal’s website is to set up Instant payment notifications.
Go back to your account settings. Click on Notifications and then, under Instant payment notifications, click on Update.
In Notification URL type https://ecomms2s.sella.it/pagam/PayPalIPN.aspx, then select Receive IPN messages and click Save.
At this point your Business PayPal account is configured to be used with Axerve Ecommerce Solutions, but in order to use it, you must send to PayPal the requested data as follows.
You have to compile and send the document “Modulo di Adesione” (given to you by the operator) with data about your business. Together with a valid ID document of the owner, you can upload your documents to PayPal:
Log into PayPal with your merchant account.
Go to Centro Risoluzioni.
Click on Risolvi.
Choose to attach your documents or send them via fax.
You’ll receive a communication by Axerve Customer Care saying that your PayPal account is correctly activated on Axerve Ecommerce Solutions.
From this moment, the payments you’ll receive will involve real money
If you try to carry out a payment, you will be able to see PayPal in the payment options:
Your customers will now be able to pay with PayPal.
Just like M.O.T.O. in Axerve Ecommerce Solutions, PayPal allows you to authorize an amount and then settle it later.
The difference between Axerve Ecommerce Solutions and PayPal is that PayPal honors 100% of authorized funds for three days. This three day period is called by PayPal the “Honor period”.
You can attempt to settle a payment without reauthorization from the fourth day to day 25 (Remember: Axerve Ecommerce Solutions maximum period for cancelling an authorization is 25 days), but PayPal cannot ensure that 100% of the funds will be available after the honor period.
PayPal reserves the right to change this behaviour if your account or the buyer’s account are restricted, locked, or fraudolent.
You can read more about the honor period in PayPal docs.
PayPal Seller protection provides Sellers from Claims, Chargebacks or Refunds that are based on:
Unauthorized Transaction
Item Not Received
PayPal Seller protection is available for eligible payments from buyers in any country.
To be eligible for PayPal Seller protection, you must meet all of the basic requirements listed here.
You can enable PayPal Seller Protection on Axerve Ecommerce Solutions contacting our customer care, once the activation has been requested to PayPal.
The Merchant can decide for every transaction whether to use the “seller protection” or not, setting the XML element ppSellerProtection to 1.
In addition, it’s necessary to set these values in the encrypted call, so that the transaction automatically includes the “Seller Protection” flag:
shipToName
shipToStreet
shipToCity
shipToState
shipToZip
shipToCountryCode
shipToStreet2
Transaction performed with PayPal Seller Protection will be marked in the Active Report of Back Office Merchant with a flag.
Here is an example of filled values. State and Country Code values are listed in the State Codes table and the Country Code table
. The field shipToStreet2 is optional.
SOAP example
1<ppSellerProtection>1</ppSellerProtection>
2<shippingDetails>
3 <shipToName>Mario Rossi</shipToName>
4 <shipToStreet>Via Roma,1</shipToStreet>
5 <shipToCity>Milano</shipToCity>
6 <shipToState>MI</shipToState>
7 <shipToCountryCode>IT</shipToCountryCode>
8 <shipToZip>20121</shipToZip>
9 <shipToStreet2></shipToStreet2>
10</shippingDetails>
You can find the information to integrate PayPal clicking on the SOAP tab. Below, the REST examples for PayPal Seller Protection and for recurring payments.
1{
2 "ppSellerProtection":"1",
3 "shippingDetails":{
4 "shipToName":"Mario Rossi",
5 "shipToStreet":"Via Roma, 1",
6 "shipToState":"MI",
7 "shipToCountryCode":"IT",
8 "shipToZip":"20121",
9 "shipToCity":"Milano",
10 "shipToStreet2":""
11 }
12}
1"payPalDescription":"description of the agreement"