Postman

Introduction

Recognizing the critical role developers play in seamlessly integrating with our API, Riverty is dedicated to providing them with cutting-edge tools and resources. Our commitment lies in reducing time-to-value and optimizing the integration process. Leveraging the power of Postman, a renowned tool in the API landscape, developers working with Riverty can effortlessly navigate, explore, and test the functionalities of our BNPL API.

Our Riverty Postman Collection encompasses exemplary use cases for all payment methods, order management operations, and supplementary supporting endpoints.

How to Import a Postman Collection and Environments from a Zip File

Install Postman
Ensure you have downloaded and installed Postman on your desktop. You can download Postman from the Postman website.

Download the ZIP File
Download the ZIP file that is mentioned above.

Extract the ZIP File
Locate the downloaded ZIP file and extract its contents using your preferred extraction tool (e.g., built-in extractor, WinRAR, or 7-Zip).
The extracted folder should contain two folders:

• Environments (multiple .json files for the Postman environments per country)
• Collections (a .json file for the Postman collection)

Open Postman
Launch the Postman application on your desktop.

Import the Collection

• In a clean workspace click the "Import" button in the top-left corner of Postman.
• In the dialog that appears, select the "Upload Files" tab.
• Browse to the extracted folder, select the collection .json file, and click "Open".
• The collection will now appear in your Postman workspace under the "Collections" tab.

Import the Environment(s)

• Open the environments on the left side of Postman
• Again click on the "Import" button
• Browse to the extracted folder, select all the environment .json files, and click "Open".
• The imported environment(s) will now appear in the list of available environments.

Insert the API key in the environment variables

• Select a country where you have active API keys for in the environments overview.
• In the variable “X-Auth-Key” paste your API key as value. By default it is showing “<<YOUR_API_KEY>>”

Set the Active Environment

• Go to the right top corner of Postman where you can choose between environments. By default it is showing “No environment”
• Select the desired environment from the dropdown to make it the active environment.

Test the Setup

• Open the imported collection under the "Collections" tab.
• Select a request, ensure the correct environment is active, and test by sending the request.