What's new?

Release Notes - 2021

Payoneer

APEXX

Computop Update

Pay.

Cardgate

Computop

Ingenico

MultiSafepay

DigiWallet

CM.com

Adyen

PayPro

Buckaroo

Partner & Integrations

PSPs

Divide

WooCommerce

Shopware 6.3

Spryker New

Shopware 5

Shopware

Magento

Magento 1 

Magento 2

Lightspeed

Shoppagina

Shoptrader

MyShop

Logic4

050media

NextChapter

Mijnwebwinkel

CCV Shop

Cloudcommerce

Shopware 6.4

Prestashop

Lightspeed App

OXID

Plugins

Partner Integration Guide

PHP test 1

Partner Integration Guide 1

Postman

Swagger

SDKs

Test data NL

Met Riverty van SOAP naar REST in Woocommerce

Our standardized connections

Our standardised integrations

Get Started

thumbnail_magento-logo.jpg

magento-logo.jpg

Magento is a popular open-source e-commerce platform. You can use our plugin to add Riverty to your Magento-based webshop.

#### Versions
Riverty supports multiple versions of Magento. Please select your version to proceed to the manual.

- [Magento 2](../../plugins/magento-2)
- [Magento 1](../../plugins/magento-1)

thumbnail_OXID_eShop_Logo.png

OXID_eShop_Logo.png

OXID  is a popular e-commerce platform. You can use our plugin to add Riverty to your webshop.

## Introduction
This guide describes the steps to quickly install, configure, test and activate the Riverty payment methods in your Oxid version 6 store. 

Riverty offers 3 different payment options via Oxid: 
- **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 payments. 

The available payment methods per country for Oxid can be found in this table:

|Country|14-day invoice|Direct Debit|Fixed instalments|
|---|---|---|---|
|**Germany**| <center>x<center/>|<center>x<center/>|<center>x<center/>|
|**Austria**| <center>x<center/>|<center>x<center/>|<center>x<center/>|
|**Switzerland**| <center>x<center/>| | |

## Setup

In this chapter we will explain how you can install and configure Riverty for your Oxid webshop. 

### Prerequisite

This module is compatible with versions 6.1.5 of the Community, Professional and Enterprise Editions. Please first make sure that this module is compatible with your shop version. Otherwise cancel the installation and contact us. Please note that the module requires an access key to function correctly, which you will receive from us. A contract on the payment methods to be offered is therefore a prerequisite for installation.

### Installation

Use Composer in the console and add the module to your shop. To do this, change to the directory in which the shop's "composer.json" is located. Call the following command:

```composer require oxid-professional-services/arvatoriverty```

Now navigate in the admin area (so-called backend) to Extension > Module and select "Arvato::Riverty". Click on overview and activate the module. 

Doublecheck if the button now shows the text "Deactivate" instead of "Activate". Now navigate to **Service > Tools** and click on **"Update DB Views now"**. Then delete the contents of the folder **SHOP-STAMMVERZEICHNIS/tmp**, only leave files that begin with a dot. You may have to log out of the backend and log back in to see all the changes. Finally, check that you can see the tab "Riverty" under **Administer Orders > Orders**. If not, carefully repeat the steps in this section.

### Basic settings
Please log into your Oxid admin page and navigate to Riverty Module.

#### General settings
- **Default Shipping Company:** Name of the delivery service that should be pre-filled when shipping is registered, e.g. "DHL" or "UPS" 
- **Standard refund description:** Text to be pre-filled for refunds, e.g. "Refund"
- **Risk management - ChannelType:** As communicated by Riverty
- **Risk management - DeliveryType:** As communicated by Riverty

#### API Settings
- **API request logging:** If logging is activated, every communication with the arvato::Riverty is logged. This log can be found under **rootdirectory/logs/ARVATO.log.**
- **API URL:** The URL to Arvato's API server, starting with https://
- **API key [payment type] [country code] [instalment payment]:** Your password to Arvato's API server, split by country code of your customer. 
- **Sandbox mode:** Instead of API-URL and API-password, Sandbox-API-URL and Sandbox API password are used (https://developer-sandbox.riverty.com/)
- **Sandbox API URL:** The URL to Arvato's API server for test environments **https://devportal-sandbox.riverty.dev/**
- **Sandbox API Key [Payment Type] [Country ID]:** Your password to Arvato's API server for test environments, divided by the country code of your customer. 


**Caution:** The log contains personal data and should be deactivated in production mode to the immense increase in file size. Installation errors are always logged regardless of this setting.

Chose the "Sandbox" to allow you to trigger test orders and test the process, before the module goes live with your shop.

**Caution: Deactivate the sandbox mode before you go live, otherwise unpaid orders may be triggered.**

#### Required fields
According to our risk standards we require mandatory fields, these vary from country to country. Please refer to [Consumer Information](https://developer.riverty.com/documentation/introduction/).

After the module has been installed, activated and configured, you will find the following payment methods in the backend under Shop Settings:
- **arvato::Riverty Invoice**
- **arvato::Riverty direct debit**
- **arvato::Riverty Instalments**

These payment methods are assigned to most customer groups by default, as well as to Germany and the standard delivery method. You can change these settings if you need more information consult the OXID documentation.

### Profile Tracking

- **Activate Profile Tracking:** If contractually agreed with Arvato, profile tracking is activated here.
- **Profile tracking URL:** As communicated by Arvato
- **Profile tracking client ID":** As communicated by Arvato.

Remember to confirm changes with the "Save" button.



### Backend

Once configured, you operate the module by selecting the relevant order under **Administer Orders > Orders** and clicking on the tab **"Riverty".** For technical reasons, the Riverty tab is displayed for all orders. If the order was not paid with Riverty, you will receive the message "No Riverty order" without any further action.

### Actions 
- **Capture pending payments:** Click on Capture to trigger the payment in the selected amount. Depending on the payment method, the buyer receives an invoice, the direct debit is triggered or the first instalment is due.
- **Cancel payment reservation:**At order completion the invoice amount was reserved. If you know that you will no longer collect the payment (for example, because the customer has canceled), you can release it here by clicking void. This makes the amount available to the customer for new purchases. With this step, you relinquish the ability to be able to process the order in the future.
- **Refund captured payments:** Click on Refund to initiate the refund of a payment. The customer is credited with the amount. If you have collected the amount in several steps, you must confirm each refund field once. This field is only visible after a capture.
- **Refund captured payments - Enter any amount:** : By clicking on refund, you can partially or fully refund an invoice previously collected by capture. Enter the gross amount to be refunded. You will find an input mask for each VAT rate in the order (e.g. 19% and 7% for Germany, as of 2018). Be careful not to mix up the VAT rates and assign the respective refunds to the correct tax rate. You can add a description to the refund such as "goodwill", "revocation", etc. or similar. This description will be displayed to the buyer on their credit note. This field is only visible after a capture.
- **Capture delivery information:** Click on Capture Shipping to record the shipment of the order. The buyer will be notified by Arvato::Riverty by e-mail about the shipment. OXID now lists the order as completed. You can specify the delivery in more detail by specifying a delivery service and, in the case of partial delivery, by specifying the goods delivered. This field is only visible after a capture.

Testing

Testing - Standard test scenarios

Testing - Payment method scenarios

Testing - Direct Debit scenarios

Testing - Instalment scenarios

Testing - Customer facing messages

Testing - Check test order

Visual guidelines

Visual guidelines - Logos and banners

Visual guidelines - Terms and conditions

Go-live - Introduction to the merchant portal

thumbnail_s_spryker.jpg

s_spryker.jpg

Spryker is a commerce operating system for customer focused companies.

Spryker

##How to configure Spryker & Riverty?

Please click on the link below to find more information on how to set-up Computop and Riverty.

Spryker Online Documentation

thumbnail_computop-logo.jpg

computop-logo.jpg

Computop Paygate offers secure payment processing for all channels including E-Commerce, mobile, and PoS. 

##How to configure Computop & Riverty?

Please click on the link below to find more information on how to set-up Computop and Riverty.

German Documentation

English Documentation

thumbnail_aci-logo.jpg

aci-logo.jpg

Awesome PSP

thumbnail_ingenico-logo.jpg

ingenico-logo.jpg

Ingenico is the global trusted partner for financial institutions and retailers, providing the most extensive network connecting acquirers and payment methods.

##How to configure Ingenico & Riverty?

Please click on the link below to find more information on how to set-up Ingenico and Riverty.



Ingenico Online Documentation

thumbnail_s_payoneer-optile.jpg

s_payoneer-optile.jpg

thumbnail_s_apexx.jpg

s_apexx.jpg

thumbnail_postman-logo.jpg

postman-logo.jpg

Download our pre-created Postman collection and start testing our API right away. All examples in the documentation are already there and you can start trying out with ease. 

POSTMAN

##How can I use Postman and Riverty?

**Open Postman** You should see an empty request window. In this window you can specify the type of request (POST, GET etc.), the URL additional field like the Headers, Body, Pre-request Script and Tests. Mostly the Headers contain values which are needed for authentication. In the case of the example for Riverty the API-Key is needed as well as a “Content-Type” which states that the body is in a JSON format. 

Those fields are required regardless of a POST or GET-Request. The Body can be empty (as in a GET-Request) or can contain several key-value pairs needed for manipulation. As the name reveals a Pre-request Script runs before a request is send in order to set some values or similar. However, it can be empty as well. Tests are “Post-Request Scripts” which can check if your request was sent successfully and had the desired results. 

For further readings and first steps in Postman, please feel free to read these instructions (https://www.getpostman.com/docs/requests). 

Postman Environments can be downloaded in the My Account > Credentials section of the Riverty Developer Portal, as they are specific to your API key. 

Riverty_Payment_API_Sandbox_Test_Sets.postman_collection.json

Sandbox Test Sets

Riverty_Payment_API_Sandbox_Environment.postman_environment.json

Sandbox Environment

thumbnail_swagger-logo.jpg

swagger-logo.jpg

We describe our API using Swagger and give you the possibility to generate your own SDK from scratch or stub server.

Get Available Payment Methods

Checkout

Order Management

Additional Services

FastTrack Services

Common

Product

Customer Account

All the API Calls in more detail

# API Documentation
 
The Riverty Management API contains resource collections to get available payment methods, authorization, capture, refund and void operations. On this page, you can find a detailed description of each operation with input parameters, possible responses, sample requests and integration examples for different platforms.

Approves the payment for a specified customer and basket. Main use-cases are One-Step and Two-Step Authorization. Full fraud and credit scoring applied. If the online-shop customer enter the incorrect address data, the system delivers a suggestion for a corrected address.

Authorize payment

Returns the available payment methods for a specified basket value and offers available for client. Returns monthly installment amount, interest and fees. Sending in customer data and contents of the basket to enhance the result is optional. If the online-shop customer enters the incorrect address data, the system delivers suggestion for a corrected address. Main use-case is Two-Step Authorize.

Available Payment Methods

Completes the payment that has been authorized. Typically done when the order is shipped. Can be a full or partial capture of the order amount.

Capture Payment

Notifies about a full or partial return registered by the consumer on the merchants web shop.

Return Notification

Refunds a partially or fully captured payment.

Refund Payment

Void (cancel) an authorization that has not been captured.

Void Authorization

Change the contents of an Authorized but not Captured order. Use this call to add or remove items in an existing Order, without creating a new orderNumber.
You must provide the entire body of the query, in the same format as Authorize, including all Order Items. (If you added an item, Update Order must contain previously Authorized items as well. If you removed an item, Update Order must contain the new full list of Order Items.)
If the TotalGrossAmount has increased compared to the Authorize call for this orderNumber, a new Risk Check will be made for the additional amount. If the additional Risk Check returns a rejection, the original Authorize will remain valid.

Update Order

Returns the contents of the specified order

Get Order

Returns all or specific captured payments of the order

Get Captures

Returns all or specific refunds of the order.

Get Refunds

Returns all or specific voided (cancelled) authorizations of the order.

Get Voids

Add new shipping details information to the capture.

Add Shipping Details

Update shipping details information of the specific capture.

Update Shipping Details

Returns address based on input (Social security number, mobile number, Organization number).

Customer lookup

Update customer

Returns the available installment plans for the specific product/basket value. Returns monthly installment amount, interest and fees. Typically used on a product page.


Available installment plans

Validates and evaluates the account and bank details in the context of direct debit payment. It is possible to transfer either the combination of BankCode and AccountNumber or IBAN and BIC

Validate bank account

Check the delivered customer addresses as well as a phonetic and associative identification of duplicates. Additionally, checks of client-specific negative or positive lists can be processed. Usually, the AddressCheck is used for the pure verification of the address data e.g. for registration processes.

Validate address

Creates an installment and/or direct debit contract that can be displayed for the customer.

Our standardized connections

Partner & Integrations

PSPs

Plugins

SDKs

About Us

Integrate Riverty

Riverty Sandbox