Magento Smart Checkout plugin

Our Magento Smart Checkout plugin allows you to accept payments via Viva Wallet Smart Checkout in your Magento store.

Overview

Features

User experience

This plugin uses our Smart Checkout solution. Customers are redirected from your checkout page on your Magento store to Viva Wallet Smart Checkout to pay, and after the customer pays, they are redirected automatically back to your Magento store.

The below images show:
a) a demo checkout page on Magento, and
b) a demo Viva Wallet Smart Checkout:

Magento Checkout Page
Smart Checkout

Supported payment methods

Smart Checkout supports a wide variety of payment methods, including:


Visa
Mastercard
American Express
Maestro
Bancontact
JCB
Discover
Diners Club
Apple Pay
Google Pay
Samsung Pay
PayPal
PayPal Pay Later
Viva Wallet
BitPay
BLIK
EPS
giropay
iDEAL
IRIS
Klarna
MULTIBANCO
P24
Payconiq
PayU
Sofort
tbi bank
Trustly
WeChat Pay
SEPA Direct Debit
Online Banking
Cash (Viva Spot)

Please see our Payment Methods page for further information on all of our payment methods

Cross-border payments: You can accept payments from international customers for all payment methods except for local payment methods and online banking

Before you start

Step 1: Create Viva Wallet account

If you do not already have an account with Viva Wallet please create an account.

Step 2: Find account credentials

Step 3: Create Payment Source

Please refer to this page for instructions on adding a new Payment Source in the Viva Wallet banking app.

You will need to use the Magento-specific Success & Failure URLs, as specified at the bottom of the above Payment Source creation page

We would highly recommend you show your company logo on your payment pages in order to increase customer recognition and trust, thus improving conversion. You can insert your company logo while creating the payment source as outlined above.

You can also change or update this logo at any time. To do this, please see our adding your brand logo tutorial for a step-by-step guide.

Step 4: Determine your payment methods

Determine which payment methods you want to offer to your customers.

Some of these payment methods are automatically enabled for you by us (e.g. Apple Pay), other payment methods can only be enabled by yourself (e.g. PayPal), for others you need to get in touch with us to enable them for you after a further review of your business.

It is not possible to activate asynchronous payment methods for the Magento Plugin

Setup instructions

Adding the Magento Smart Checkout plugin consists of the following steps.

Step 1: Add Viva Wallet Smart Checkout plugin to your Magento store

  1. Download the Magento Smart Checkout plugin (ZIP file) to your device

  2. Unzip the downloaded ZIP file

  3. Open the directory containing the source files (magento_vivawallet/Ced/VivaPayments)

  4. Access your Magento directory and upload all files from the above directory to your Magento installation (new files will be added to your app/code/Ced/VivaPayments folder within Magento)

  5. Run the following commands within Magento (you will need to ensure you have write permissions – please see here for more details on how to run commands):

    • Enable module: bin/magento module:enable --clear-static-content Ced_VivaPayments
    • Upgrade database: bin/magento setup:upgrade
    • Re-run flush command: bin/magento cache:flush
    • Re-run compile command: bin/magento setup:di:compile
  6. Navigate to STORES > Configuration from the main menu within the Magento Admin panel:

    Magento Configuration

  7. Navigate to payment methods under the Sales tab:

    Magento Payment Methods

  8. Locate the Viva Wallet Smart Checkout module - within the settings panel, fill in the following fields:

    Magento Settings

    • Enabled: Check this box to enable the plugin

    • Title: Enter the title to display to customers on the Checkout screen

    • Merchant Id: Enter the Merchant ID you noted in Step 2: Find Account credentials

    • API Key: Enter the API Key you noted in Step 2: Find Account credentials

    • Source Code: Enter the Source Code of the Source you created in Step 3: Create Payment Source

    • OrderCode URL:

      • Enter https://www.vivapayments.com/api/orders if you are using a live Viva Wallet instance
      • Enter https://demo.vivapayments.com/api/orders if you are using a demo Viva Wallet instance
    • Gateway URL:

      • Enter https://www.vivapayments.com/web/newtransaction.aspx if you are using a live Viva Wallet instance
      • Enter https://demo.vivapayments.com/web/newtransaction.aspx if you are using a demo Viva Wallet instance
    • Transaction URL:

      • Enter https://www.vivapayments.com/api/transactions if you are using a live Viva Wallet instance
      • Enter https://demo.vivapayments.com/api/transactions if you are using a demo Viva Wallet instance
    • Installments: This is an optional field, only applicable to Greek merchants – you can set the maximum allowed payment card installments and their corresponding order values

  9. When complete, save these settings and the Viva Wallet Smart Checkout payment option will be available in your checkout

Step 2: Review additional information, if needed

Upgrading the plugin

Keeping the plugin up to date help improve user experience with the addition of new features as well as improvement of existing features.

  1. To find the existing version of the plugin, access your Magento directory and open changelog.txt file under app/code/Ced/VivaPayments folder. The version with the most recent date shows your current version.

  2. Check the Release Notes page and search for Magento plugin releases. If you see a newer version, download it from this link.

  3. Unzip the downloaded ZIP file, copy the VivaPayments folder from the directory magento_vivawallet/Ced/ and replace it with VivaPayments folder under Magento’s app/code/Ced/ directory.

  4. Run the following commands within Magento directory – please see here for more details on how to run commands

    • Enable module: bin/magento module:enable --clear-static-content Ced_VivaPayments
    • Upgrade database: bin/magento setup:upgrade
    • Re-run flush command: bin/magento cache:flush
    • Re-run compile command: bin/magento setup:di:compile

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!