riverty logo

Docs

FAQ

If your question is not listed here, please feel free to contact us.

Onboarding

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.

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.

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.

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

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

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.

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.

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.

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

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

Testing

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.

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

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.

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

Live

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

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.

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.

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.

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.

Contact Client Support at support@riverty.com.

Dispute Management

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.

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.

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.