PayPal

Information on the PayPal payment method for online payments.

• Introduction
• User Experience
  • Screenshots
  • Videos
• Details
• Merchant Categories
• How to activate PayPal
  • Pre-requisites
  • Live/production mode
  • Sandbox/demo mode (optional)
• How to deactivate PayPal
  • How to re-activate PayPal
• Issuing customer refunds
  • Through PayPal
  • Through Viva Wallet
• Testing PayPal
• Payment method messaging
• Get Support

Introduction

PayPal is offered by Viva Wallet as a payment method to all its eligible merchants. This allows your customers pay you online using their PayPal account if they wish to do so.

Some of the main benefits of offering PayPal as a payment method are:

• Increased sales: It can make your store more accessible to customers who prefer to use PayPal to make online purchases
• Expand your customer base: It can make it easier for you to sell to customers in different countries, as PayPal allows users to make payments in a variety of currencies, and it also offers automatic currency conversion for international transactions
• Customer trust: PayPal is a well-known and trusted payment provider, so offering it as a payment option can help to increase customer trust in your store, and make customers more comfortable making purchases from your store
• Customer convenience: It can make it easier for customers to complete their purchases on your online store, as PayPal allows customers to pay with just a few clicks, using their PayPal account or a credit or debit card linked to their account

User Experience

Screenshots

At the checkout, the customer selects PayPal (or PayPal Pay Later) as their preferred payment method:

The customer is directed to a PayPal-hosted page where they log in to PayPal using their account credentials:

The customer then selects their preferred payment method from the list:

PayPal’s Pay Later options are also included here, in addition to PayPal balance, card payment and bank transfer:

After the customer clicks ‘Pay Now’, PayPal notifies the merchant of the successful transaction and the customer is directed back to the merchant:

Videos

Please also see our videos below, outlining the desktop and mobile use of PayPal:

Desktop:

Mobile:

Details

• How to activate: Please refer to the How to activate section below. Please note: Activation of this payment method is instant. Once activated, merchants will immediately be able to accept payments via PayPal
• Payment method type: Synchronous - payments are confirmed immediately
• Refunds: Supports partial and full refunds
• Recurring payments: Not yet supported
• Pre-authorizations: Not yet supported
• Restricted MCC: Some Merchant Categories are not eligible to have PayPal activated
• Μerchant countries (PayPal): Austria, Belgium, Croatia, Cyprus, Czech Republic, Denmark, Finland, France, Germany, Greece, Hungary, Ireland, Italy, Luxembourg, Malta, Netherlands, Poland, Portugal, Spain, Sweden & United Kingdom
• Μerchant countries (PayPal Pay Later): France, Germany, Italy, Spain & United Kingdom
• Customer countries: All countries
• Pricing: Please refer to our pricing page under the main navigation for more information
• Settlement: Customer payments via PayPal will be deposited to your PayPal account (not your Viva Wallet account) and settled within 2 hours
• Cross-currency payments: PayPal does support cross-currency payments
• Additional notes: PayPal is not available through Quick Pay or for payment orders with the disableExactAmount parameter set to ‘true‘

Merchant Categories

There are some merchant categories that are not eligible to have PayPal activated. If your business is in one of these categories, you will not be able to accept payments through PayPal:

How to activate PayPal

Please see the steps below in order to activate PayPal integration with your Viva Wallet account in production.

Pre-requisites

Before integrating your PayPal and Viva Wallet accounts, please note the following:

• The integration will function only if your PayPal Business Account has been fully approved by PayPal and can accept payments
• Viva Wallet and PayPal accounts have a one-to-one relationship, meaning:
  • You cannot link the same PayPal account to multiple Viva Wallet accounts
  • You cannot link the same Viva Wallet account to multiple PayPal accounts

Live/production mode

If you want to integrate with PayPal with your live (production) Viva Wallet account, follow the procedure below:

1. Sign in to your production Viva Wallet account

2. Click on Settings > API Access and scroll down to the PayPal (Payment Method) section

3. Click on the Enable PayPal as a payment method button:
   
   
   A PayPal popup window is displayed

4. Do one of the following:

   • If you already have a PayPal Business Account:

     1. Enter your registered email address, select your country and click on the Next button.
        Another popup is displayed

     2. Enter your password and click on the Log In button.
        A message is displayed about confirming your email address. Setup is now complete

   • If you do not already have a PayPal Business Account:

     1. Enter the email address you wish to register, select your country and click on the Next button.
        The Set up your PayPal Business Account window is displayed

     2. Create and confirm your password and click on the Next button.
        The Please tell us about your business window is displayed

     3. Complete the required details and click on the Agree and Create Account button.
        Two more windows are displayed requesting details about your business and you

     4. Complete the first of these then click on the Next button

     5. After completion of the second window, click on the Submit button.
        A confirmation window is displayed stating that you need to confirm your email address to activate your account

     6. Go to your email and confirm activation of your PayPal account

5. Close the window and refresh the Settings > API Access page. You should see a temporary message in the PayPal (Payment Method) section indicating that setup is in progress:
   
   
   Nothing else is required from your side, PayPal will appear as a payment method once PayPal approves the integration

6. Please note:: If you refresh the page again in around 2 minutes or so, the message will update to the below which indicates that the PayPal payment method is successfully set up:
   
   

Sandbox/demo mode (optional)

If you want to integrate with PayPal with your sandbox (demo) Viva Wallet account, follow the procedure below. This includes the process to create a PayPal Sandbox account (steps 1 to 11):

1. Visit developer.paypal.com and click on the Log Into Dashboard button at the top-right of the page:
   
   
   The PayPal login page is displayed

2. Enter the email address / mobile number and password of your PayPal Business Account and click on the Log in button
   

3. A dialog box requesting a further authentication step may be displayed. If this is the case, choose your preferred option and click on the Next button. Once fully logged in, the My apps & credentials page is displayed
   

4. Ensure that the Sandbox tab under the page title is selected:
   
   

5. Click on Accounts in the left nav in the Sandbox section

6. Click on the Create account button.
   The Create Sandbox Account dialog box is displayed

7. With the Business (Merchant Account) radio button selected, choose the country for your sandbox account:
   
   

8. Click on the Create button.
   After a little bit of time, the Sandbox test accounts page should be displayed with the new account listed

9. Click on the three dots under Manage accounts:
   
   

10. Select View/edit account from the sub-menu that pops up.
    The Account details window is displayed:
    
    

11. Make a temporary note of your Email ID and System Generated Password for later on

12. Sign in to your demo Viva Wallet account

13. Click on Settings > API Access and scroll down to the PayPal (Payment Method) section

14. Click on the Enable PayPal as a payment method button:
    
    
    The PayPal test store popup window is displayed:
    
    

15. Complete the Email field with the Email ID you made a note of earlier, and select country from the drop-down to match the country of the sandbox account you recently set up

16. Click on the Next button
    A window is displayed prompting you to enter a password:
    
    

17. Complete the Password field with the System Generated Password you made a note of earlier

18. Click on the Log in button. An example PayPal account summary window is displayed

19. Close the window and refresh the Settings > API Access page. You should see a temporary message in the PayPal (Payment Method) section indicating that setup is in progress:
    
    
    Nothing else is required from your side, PayPal will appear as a payment method once PayPal approves the integration

20. Please note:: If you refresh the page again in around 2 minutes or so, the message will update to the below which indicates that the PayPal payment method is successfully set up:
    
    

How to deactivate PayPal

Please follow the steps below to deactivate PayPal for your Viva Wallet account.

1. Sign in to your production Viva Wallet account or your demo Viva Wallet account

2. Click on Settings > API Access and go to the bottom of the page

3. You may find the PayPal Payment method section:
   
   

4. Click on Disable PayPal as a payment method button:
   
   

5. A notification pop-up will be displayed to confirm your PayPal deactivation request as payment method:
   
   

6. Please note:: If you refresh the page again in around 2 minutes or so, the PayPal section will be hidden:
   
   
   

How to re-activate PayPal

After deactivating PayPal as a payment method, if you wish to re-activate it at a later date, please follow the steps below.

These steps will vary depending on whether you:

• Deactivated PayPal from within your Viva Wallet self-care account (by following the steps above)
• Deactivated PayPal from within your PayPal account

From within your Viva Wallet self-care account

If you deactivated PayPal from within your Viva Wallet self-care account, please contact our support team via the Live Chat feature at the bottom-right of this page.

You will need to provide us with your Viva Wallet Merchant ID as well as your PayPal Merchant ID or Vendor ID.

To find your PayPal Merchant ID or Vendor ID:

1. Sign in to your PayPal account

2. On the right-hand side user menu, mouse over and select the Account Settings option:
   
   

3. You may find the PayPal Merchant ID or Vendor ID under the Business Information tab:
   
   

From within your PayPal account

If you deactivated PayPal from within your PayPal account, please first follow the steps below to re-grant permissions to Viva Wallet:

1. Within the Account Settings page, navigate to the Account access tab and click on the Update button next to API access:
   
   

2. Click on Manage API permission:
   
   

3. Here, click on the Add a new third party link:
   
   

4. Within the following page, please search for and link a new third party using your Viva Wallet Merchant ID

Once you have completed the above steps, please contact our support team via the Live Chat feature at the bottom-right of this page.

You will need to provide us with your Viva Wallet Merchant ID as well as your PayPal Merchant ID or Vendor ID.

To find your PayPal Merchant ID or Vendor ID:

1. Sign in to your PayPal account

2. On the right-hand side user menu, mouse over and select the Account Settings option:
   
   

3. You may find the PayPal Merchant ID or Vendor ID under the Business Information tab:
   
   

Issuing customer refunds

A full or partial refund can be made to a customer at any time for an order already placed with funds received into PayPal. Refunds can be made either through PayPal or through Viva Wallet.

Please note the following regarding PayPal refunds:

• Regardless of the method used, refunds will update both the payment in your PayPal Business Account and the related Sales Transaction in your Viva Wallet account
• Refunds will not be displayed within the ‘Sales’ > ‘Sales Transactions’ page in your Viva Wallet account until PayPal has finished processing them

Through PayPal

To issue refunds through your PayPal Business Account, please see How do I issue a full or partial refund? in the PayPal Help Center.

Through Viva Wallet

To issue a refund through Viva Wallet:

1. Sign in to your production Viva Wallet account

2. Go to Sales > Sales Transactions and click on the Search button with the required date range selected to display a list of transactions:
   
   

3. Find the required transaction labelled PayPal Charge

4. Click on the Refund button. The Refund Transaction dialog box will be displayed:
   
   

5. You can then do one of the following:

   • To issue a full refund:

     1. Ensure the entered ‘Amount to be refunded’ is the same as the original payment amount

     2. Click on the OK button

   • To issue a partial refund:

     1. Ensure the entered ‘Amount to be refunded’ is smaller than the original payment amount

     2. Click on the OK button

   In both cases, a PayPal-related confirmation message will be displayed confirming the amount to be refunded:
   
   

Testing PayPal

In order to test PayPal functionality in the demo environment, please see our PayPal testing information.

Payment method messaging

It is important that the customer is aware of the payment methods you offer via Smart Checkout, as this will increase conversion and average order values. Please see our payment method messaging guide for more details on why and where we would recommend adding this information to your site.

If desired, you can download and use this icon on your site or online store, in order to show customers you offer PayPal as a payment method:

Get Support

If you would like to integrate with Viva Wallet, or if you have any queries about our products and solutions, please see our Contact & Support page to see how we can help!