PrestaShop is a popular e-commerce platform. You can use our plugin to add Riverty to your webshop.
Riverty has developed a module that easily integrates with a Prestashop-based webshop. It is a simple way to let your customers start using Riverty at checkout. You don’t need advanced technical skills to add Riverty to your Prestashop webshop! This guide describes the functionalities of the Riverty module for Prestashop and how to set it up in your webshop.
We offer 3 different payment options:
- 14-day invoice - This is the default 14-day invoice payment method in Riverty. It is always available in every market where Riverty operates. It is primarily meant for business-to-consumer sales.
- Direct Debit - This is a Direct Debit version of the 14-day invoice payment method Instead of receiving an invoice to be paid via their bank, the customer enters their bank details, and the money is immediately deducted from their bank account.
- Instalments - This is a Part Payment invoice. The customer can split their purchase over multiple monthly fixed payments.
The payment methods that are available via this plugin are:
|Country||14-day invoice||Direct Debit||Fixed instalments|
Here's how to get started with using Riverty
- You need a running Prestashop instance, installed on your webserver (v1.6 or above).
- Install the Riverty plugin. The plugin is currently only available as ZIP file. In the near future it will be available through the Prestashop Marketplace.
The installation of the Prestashop Plugin can be done through the Prestashop Module Manager, which can be found under Improve > Modules > Module manager. In the Module manager, you have to upload the module by clicking on the button Upload a module. A screen will appear in which the ZIP file can be uploaded.
The module will automatically be installed after uploading, and when the installation is successful it can be configured by clicking on Configure.
First thing to set up is your Riverty Credentials and API key. Make sure to enter the API key for the corresponding country where your webshop will be accepting payments.
- If you just want to try Riverty without commitment, you can get one via the Developer Sandbox.
- Access to Partner Test credentials will be provided by your Implementation Manager at Riverty.
- When you are ready to go live, contact your Implementation Manager at Riverty. They
will configure your webshop in the Riverty backend, and give you your Production API Key.
On you have set up your API credentials choose an Environment to connect to:
- Partner Test
With a successful connection running you can start testing and accepting payments with Riverty.
Download the AfterPay Prestashop plugin
You can download the latest version of the Riverty Prestashop plugin (version 1.7.0). By clicking on the following link:
To access the configuration options open the Prestashop Admin Panel, navigate Improve > Modules > Module manager > Riverty and click on Configure. The Riverty plugin provides extra settings that can be used to customize the behavior further. Expand the sections, and fill them in as described below. There is a separate section for each country showing the specific Riverty payment methods that are available (Invoice, Direct Debit, etc.). Payment methods are disabled by default, and must be enabled explicitly in their settings.
A few points of notice, before configuring:
- You can have more than one payment method per country. - For example, you can have both Digital Invoice and Direct Debit enabled in the Netherlands. Both options will show up at checkout.
- A payment method will only work for customers from that country. - For example, if you only have the Riverty Belgium Digital Invoice payment method enabled, Riverty will not be available to customers whose address is in the Netherlands.
There are also three settings panels that are not payment methods: Address Lookup Settings, Tax Settings and Developer Settings.
The general settings tab contains general settings for the module and settings for the order management operations.
|Enabled||If this is set to Yes, the Riverty payment module will be enabled and ready to use.|
|Debug log||If this is set to Yes, a debug log will be written to the folder var/logs. This log will contain information from the requests and responses to Riverty. It is advised to not use this function in production.|
|Debug email||The debug email can be used to send the debug log after a transaction is completed.|
|IP Restriction||With the IP restriction the payment method can be shown only to customers with a certain IP. this can be used for example in the testing phase, to not show the payment method to everyone. To enable this, the IP address should be filled in.|
|Use captures||If this is set to Yes, the Riverty payment module will automatically sent a capture request to Riverty after the order is accepted by Riverty. After a capture request is done Riverty will start the invoicing process.|
Payment method settings
Each payment method has a section with settings, which in general are all the same. To enable a payment method it should be enabled, an API key should be filled in and the correct connection method should be configured.
The following configuration options are available per payment method:
|Enabled||If this is set to Yes, this Riverty payment method will be available to customers in this country.|
|Title||The name of this payment method, as displayed to the customer at checkout.|
|Description||A short description of this payment method, as displayed to the customer at checkout.|
|API key||The Auth key for transactions. Depending on the “Test mode” a production, test or sandbox key can be used.|
|Merchant ID||Field which can be used to distinguish separate sites. This options should only be used in agreement with your contact at Riverty.|
|Lower threshold||The smallest purchase that a customer can make in your webshop when paying with Riverty. If the total sum of the shopping cart is lower than this number, this payment method is not displayed at checkout. Leave empty to set no bottom limit.|
|Upper threshold||The biggest purchase that a customer can make in your webshop when paying with Riverty. If the total sum of the shopping cart is higher than this number, this payment method is not displayed at checkout. Leave empty to set no upper limit.|
|Test mode||Select No to use the Production connection. Select Yes to use the Test connection. Select Yes – Sandbox to use the Sandbox connection|
|Show phonenumber||If this is set to Yes, the Riverty section of your checkout page will ask the customer to enter their phone number.|
|Show birthdate||If this is set to Yes, the Riverty section of your checkout page will ask the customer to enter their date of birth.|
|Show gender||If this is set to Yes, the Riverty section of your checkout page will ask the customer to enter their gender.|
The following options are available on some payment methods:
|Show Bank IBAN input field||If this is set to Yes, the Riverty section of your checkout page will ask the customer to enter their Bank IBAN number.|
|Show Bank BIC / Swift input field||If this is set to Yes, the Riverty section of your checkout page will ask the customer to enter their Bank BIC / Swift code.|
|Show company name input field||If this is set to Yes, the Riverty section of your checkout page will ask the customer to enter their company name.|
|Show chamber of commerce number input field||If this is set to Yes, the Riverty section of your checkout page will ask the customer to enter their chamber of commerce number.|
To ensure successful integration of the Riverty services, it is vital that a vigorous testing is performed. Please refer to the Testing section of the Riverty integration guide for detailed guidelines on testing scenarios.
In this chapter, we will explain which steps you need to take to enable the payment method on production.
Configure live mode
Once you and your Implementation Manager are satisfied with the validation of account setup and testing, you will get a Live Auth key and can start offering Riverty to your customers!
Note, you will only get the Live Auth Key after you have signed the contract with Riverty.
Congratulations! You just went live with your Riverty connection. Please notify your Riverty Implementation Manager that you went live. If you encounter any issues in the upcoming week you can contact your Riverty Implementation Manager. After that period you can contact our local Merchant Desk for help.
Introduction to the Riverty Merchant Portal
You can go to the Merchant Portal here. Once logged in, you will also see an in-depth guide on how to best use it.
In the merchant portal you can:
- View and mutate your Riverty orders
- Get financial reports
- Setup your branding in the Riverty systems