PayPal

Information on the PayPal payment method.

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.

This integration also includes PayPal Pay Later functionality, which is enabled by default when PayPal is activated successfully for your account

Pre-requisites

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

User Experience

Screenshots

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

PayPal - User Journey - 1

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

PayPal - User Journey - 2

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

PayPal - User Journey - 3

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

PayPal - User Journey - 4

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

PayPal - User Journey - 5

Videos

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

Desktop:

Mobile:

Details

Merchant Categories

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

Merchant Category (MCC) Description
5499 Misc. Food Stores – Convenience Stores and Specialty Markets
5967 Direct Marketing – Inbound Teleservices Merchant
7841 Video Tape Rental Stores

How to enable PayPal

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

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:

    Enable PayPal as a payment method
    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:

    Enabling PayPal 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:

    Disable PayPal as payment method

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:

    Log in to dashboard button
    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:

    Sandbox tab

  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:

    Create 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:

    Sandbox test accounts

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

    Account details

  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:

    Enable PayPal as a payment method
    The PayPal test store popup window is displayed:

    PayPal test store

  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:

    PayPal password window

  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:

    Enabling PayPal 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:

    Disable PayPal as payment method

How to disable PayPal

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

We would recommend disabling PayPal from within your Viva Wallet self-care account by following the steps below. This way, PayPal can easily be re-enabled in the future, if desired

  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:

    PayPal Payment Method Selfcare Section

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

    Disable PayPal Payment Method

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

    Notification Pop Up for Payapal Deactivation

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

    PayPal Section in SelfCare hidden

How to re-enable PayPal

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

These steps will vary depending on whether you:

From within your Viva Wallet self-care account

If you disabled 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:

    Mouse over on Account Settings

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

    Merchant ID

From within your PayPal account

If you disabled 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:

    Check PayPal Consents

  2. Click on Manage API permission:

    Check PayPal Consents

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

    Check PayPal Consents

  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:

    Mouse over on Account Settings

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

    Merchant ID

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:

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:

    PayPal sales transaction

  3. Find the required transaction labelled PayPal Charge

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

    Refund transaction

  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:

    PayPal refund confirmation message

Payment method icon

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:

Payment Method Icon - PayPal

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 Get Support page to see how we can help!