If your question is not listed here, please feel free to contact us using the support tab.


1. When do we get access to the test environment/production environment?

Simply sign up using our Onboarding Widget and you will immediately gain access to our test environment. You can gain access to the production environment by completing the next steps presented within the test environment. Time to gaining access to production varies depending on the KYC, contract signing, and integration testing.

2. What is the difference between sandbox, the test environment and the production environment?

Sandbox: Sign up in 2 minutes to gain access to a technical testing environment for API calls, logs, and error message triggering.

Test Merchant Portal Account: Sign up in 10 minutes to gain access to a test Merchant Portal account for creating test clients, managing transactions, employee roles/permissions, uploading item images, and more.

Product Merchant Portal Account: Once fully onboarded, you will gain access to our production environment to begin processing live transactions. The Hypercare Team will also monitor your integration to make sure everything is functioning properly.

3. Which store systems are supported by Riverty?

Riverty our Shopping Platform and PSP Partner pages to learn who we partner with. If none of these partners fit your needs, you can directly integrate into our API.

4. What is the endpoint for the test environment?

The endpoint for the sandbox: https://devportal-sandbox.riverty.dev/

The endpoint for the test environment: https://api.bnpl-pt.riverty.io

You can learn more about both of these systems in our Introduction Documentation.

The endpoint for the production environment: https://api.bnpl.riverty.io

5. Do I get a technical contact?

Depending on the complexity of our integration, you may be assigned a technical contact. However, the majority of our clients simply use our standard contact points

6. Which fields within the API calls are necessary?

All requires fields are marked “required” in our API Specifications. Please note, some fields may not be required depending on your country of business. Please follow the error codes accordingly or contact our support team.

7. Do I need a separate API key for each country?

Yes, for the live and test environment you need a separate API key for each country. However, you can create your own API keys for each country in our Sandbox.

8. Is the implementation of profile tracking mandatory?

Profile tracking is standard, some exceptions may apply. With a Direct Integration you need a profile tracking tag, whereas with a Platform/Pluing or PSP integration you only need to insert the profile tracking ID into the corresponding field.

9. How do I implement profile tracking?

You will receive a profile tracking guide from a Riverty Representative during the Onboarding process.

10. Where do I get the profile tracking ID from?

You will receive a profile tracking ID from a Riverty Representative during the Onboarding process.


1. Does Riverty have an Integration Guide?

Yes, we provide integration guides for PSPs, Plugin/Platform and Direct Integrations. Please note, the guides are a starting point, but you may need to contact your PSP, Plugin/Platform provider, or the Riverty Implementation Team to complete integration.

2. What does the following error code xxx tell me?

You can learn more about our error codes on our Response Codes Page or check the specific API call pages in our API Specifications.

3. Why don't we receive billing emails for trial orders?

You can fully test your transaction management system with a Merchant Portal Account. Simply enter your email in the test data when prompted to receive the corresponding emails.

4. How can I create test orders?

You can create test orders in both our Sandbox and Merchant Portal


1. How can I put an invoice on hold?

You can place an invoice on hold via the Merchant Portal. Simple select the transaction, click the "more" drop down, and select "pause."

2. How do I resend an invoice?

You can resend an invoice via the Merchant Portal. If customer has not received the invoice, verify customer's email address and if it matches with the one visible in the order details you can use the Resend functionality to send the invoice again. Click the More button in the invoice section and select Resend.

3. Does an invoice number have to be transferred?

An invoice number is not required. If an invoice number is provided, it will be used. If none is provided, the API will assign an invoice number automatically.

4. Why is the capture rejected?

Please double check the order information and any response codes. This may be due to incorrect item information or a duplicated capture code. If all information appears correct, please contact client support at support@riverty.com.

5. Why was the transaction rejected?

The transaction can be rejected for various reasons. Please check any response codes for further details. Most likely, the customer did not pass the risk check. If you believe a technical error is at fault, please contact client support at support@riverty.com.

6. An error has occurred with an order and I can't get any further. What can I do?

Contact Client Support at support@riverty.com.

Dispute Management

1. A customer is disputing an order, what do I do?

Contacting the consumer to resolve the order directly is often quickest and easiest way to settle a dispute. If you are unable to resolve the dispute directly, please save any order documentation and written communication.

2. How do I know when a customer has disputed one of my orders?

Riverty’s dispute management team will contact you either via email or phone to inform you about the dispute and discuss next steps to settle the dispute.

3. When do I have to respond to your emails with disputes?

The quicker you contact the customer who raised the dispute to provide solutions, the more likely the dispute will resolve with favorable terms. Typically, Riverty expects merchants to respond to dispute requests within 3 business days, however fraud-related disputes may require immediate attention.