Riverty Logo


Please select your page

Getting Started - Plugin Integration

Plugin Integration

Our Environments:

There are two different environments.

Test environment:
The test environment should be used to verify a successful Riverty integration as you don't want to run into any unexpected issues, when switching Riverty live. Endpoint https://api.bnpl-pt.riverty.io/. To use the Test-Environment you will need a dedicated api key, which you will either receive in an e-mail from your integration manager or through the Merchant Portal. Please note that for the test environment you get at least one API key per country. To ease the testing, the system does not 100% mimic the production environment. A full E2E test can only be done to some extend.

Production/ Live-Environment:
The Production-Environment is the place where the real incoming orders will happen. Endpoint https://api.bnpl.riverty.io/. You will receive at least one API key per shop, per country and per currency. For further questions please contact your implementation manager.

Integration Documents:

Before switching to the Integration Guide, please note the following:

Minimal Requirements Documentation:
You can download our Minimal Requirements Documentation for the DACH region here. This document describes, how to make your Shop compliant with Riverty.

Test suite:
You can download the test suite here. The test suite includes various scenarios, not all of them necessarily will apply to your integration. We recommend that you execute these test cases before going live so that you can be sure that your integration works as intended and that you don’t run into any issues in production. After you have executed the tests, please send us the corresponding order numbers. We will then check our logs and report the results back to you.

Validation and Error codes:
Here you can find error codes sent by our API including a description. You can do a lot of quick trouble shooting by just looking at the error codes you receive.

Click here to select your integration method

Merchant Portal:

Merchant Portal - access:
The Merchant Portal is a powerful tool with several functionalities from order management up to account data access.
To log into the merchant portal, we have sent an invite per email to you. You might have already received that email at an earlier stage. Please check your email inbox and spam folder.

The Merchant Portal exists in the test environment and in the production environment, so don't get confused.
The API keys for test will be in the Merchant Portal Test.
If you can't find your Test API key in the Merchant Portal yet, please contact your implementation manager.

The API keys for production will be in the Merchant Portal Production.
Your implementation manager will share the link with you after successful completion of the integration test.

Merchant Portal Guide:
You can find our Merchant Portal Guide here.

Shop Logo and Hero Image:
In the merchant portal you can provide your logo and add a hero image. These images will be shown on the invoices sent to your consumer. Your individual branding will help your consumers, to link the invoice to the purchase in your shop.
You will find the branding option in the Merchant Portal when clicking on the 3 line in the top right corner.

Riverty 2023