riverty logo

Docs

Get Started Login

Digitwallet

DigiWallet is a digital wallet and payment service provider that facilitates secure online payments across various industries, including e-commerce and digital services.

Website: https://www.digiwallet.nl/

Type: PSP

Introduction

This guide describes the steps to quickly install, configure, test and activate the Riverty payment methods in your DigiWallet connected store.

DigiWallet currently offers this payment method:

  • 14-day invoice - This is the default 14-day invoice payment method in Riverty. 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.
  • B2B invoice - This is the B2B consumer version of the default 14-day invoice payment method in Riverty.

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

Country 14-day invoice Direct Debit Campaign invoice Fixed instalments Flex payment B2B invoice
The Netherlands x x x
Belgium x
Germany
Austria
Switzerland
Sweden
Norway
Finland
Denmark

Setup

In this chapter we will explain how you can configure Riverty for your DigiWallet connected webshop(s).

Configure test mode

At this point you should have received the API keys from Riverty. If this is not the case you can reach out to your contact person at Riverty or to sales@afterpay.nl.

Once you received the keys from Riverty you can forward them to sales@targetmedia.eu. DigiWallet will respond to this mail with the confirmation that they configured the keys for test. Please follow the instructions of DigiWallet to make Riverty accessible for you to start testing. DigiWallet's AfterPay API documentation can be found here https://www.digiwallet.nl/nl/documentation/afterpay

Note - The orders that are send to our test environment are not processed, invoiced and paid. We recommend testing Riverty in a non-publicly accessible test environment, in order to prevent real orders from coming in during the test phase. If this is not possible, we advise you to block the payment method based on IP address or clearly indicate that the payment method is in test mode if this is also not possible.

Testing

After completing the setup the next step is to test the connection.

Standard test scenarios

Please submit the following test scenarios. To check your own test transactions proceed to paragraph "check test order" below. Complete the table with your order numbers and send it to your Riverty Implementation Manager. You can put multiple test cases in one order but please refer to the right order number after each testcase.

# Test case Order number
1. Test an order with multiple products
2. Test an order with a fixed discount
3. Test an order with a percentual discount
4. Test an order with a shipping fee
5. Test an order with an alternate delivery address
6. Test an order with pick-up points (if applicable)
7. Test an order with store pick-up (if applicable)
8. Test an order with a house number addition
9. Test and make sure the VAT is correctly received by Riverty

Payment method scenarios

After you tested all standard scenarios for the 14-day invoice you should start testing the other payment methods you activated. Please complete the tables with your order numbers and send them to your Riverty Implementation Manager.

If you want to integrate invoice for Business to Business please proceed with this test order:

# Test case Order number
B-1. Test an order with the Business to Business payment method

Customer facing messages

It is also necessary to check if the error messages are correctly shown to the customer.

  • Test a rejected authorize. Please make sure that the customer friendly message is displayed correctly in the check-out.
  • Test validation error. Please make sure that the customer friendly message is displayed correctly in the check-out.

Check Test Order

You are able to verify the transactions on the Riverty side by yourself. You can do this with the Get Order call. You can send these calls for example with Postman. The response will show you how the transactions a registered on the Riverty side. Documentation for the Get Order call can be found below.

Get Order

Visual Guidelines

In this chapter we will explain the Riverty visual guidelines you need to apply to your webshop.

Logos and banners

For convenience and a familiar customer experience, please integrate/enclose the Riverty badge in your Checkout next to the payment method. Please refer to our UX guidelines on the checkout best practises:

When Implementing the Riverty badge throughout the shopping experience please ensure you are using our URL, not by downloading the image. The Riverty badges are hosted on a Content Delivery Network (CDN) to ensure the best performance and availability for your website. Furthermore, you do not have to care about changes, which are all done by Riverty.

We provide two types of badges through our CDN - .svg and .png. We recommend using the Riverty badge as a .svg file with regard to the quality and size of the file. If you prefer .png just change the end of the URL to .png.

Terms and Conditions

Riverty mandates that consumers be presented with Riverty's terms and conditions and Privacy Policy upon checkout. Thus the option to display the T&C should always be enabled in the plugin configuration. In certain cases where you would like to incorporate the Riverty T&C and Privacy Policy within your own Terms and Conditions, this must be done only with approval from Riverty's legal counsel. After approval include the country specific T&C and Privacy Policy resources.

Go-Live

In this chapter we will explain which steps you need to take to enable the payment method on production. For the final go-live a contract between you and Riverty is required.

Riverty Merchant Portal

Be sure to sign up for a free Riverty Merchant Portal Account!

Initial sign-up will provide a test Merchant Portal account for you to explore, manage test transactions, and access test API keys. A full guide can be found in the portal's collapsed left menu. The live portal is provided once KYC and contract signing are complete.

Done

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.