MenuPlease select your page
CardGate payment plugin for Riverty and Buy Now Pay Later
CardGate is a popular PSP. You are able to offer Riverty via CardGate.
This guide describes the steps to quickly install, configure, test and activate the Riverty payment methods in your CardGate connected store.
CardGate 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.
The available payment methods per country for CardGate can be found in this table:
|Country||14-day invoice||Direct Debit||Campaign invoice||Fixed instalments||Flex payment||B2B invoice|
In this chapter we will explain how you can configure Riverty for your CardGate 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 firstname.lastname@example.org.
To be able to start with Riverty via CardGate, the payment option Riverty must be activated within your CardGate account. If you have already stated this when registering, it is already active. If you want to have the payment option Riverty active afterwards, this must be passed on to CardGate. You can send a message via My CardGate or call 088 12 62 888.
Activate test account in your webshop
To be able to test, the test account (containing the payment method Riverty) must be linked to your webshop. For this you can contact the CardGate support department. You can send a message via My CardGate or call 088 12 62 888.
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. 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|
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.
Returns the contents of the specified order
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 logo in your Checkout next to the payment method. Please refer to our Merchant Playbook for full details on how to make the customer experience smooth and frictionless.
When Implementing the Riverty logo throughout the shopping experience please ensure you are using our URL, not by downloading the image. The Riverty logos 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 logos through our CDN - .svg and .png. We recommend using the Riverty logo 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. We also offer the Riverty logo in different color schemes. Depending on your individual website background, choose the Riverty logo that fits best.
|Riverty-AfterPay Checkout Logo in SVG||https://cdn.riverty.design/logo/riverty-checkout-logo.svg|
Terms and conditions
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.
Configure live mode
After you have successfully completed the tests (if applicable for your integration), Riverty will share the live keys. CardGate will configure the keys in their system. Please follow the remaining instructions from CardGate to activate Riverty on your production environment.
Last check (Only applicable for the BeNeLux)
Now that Riverty is live, we only have to check whether orders are also coming in properly.
You can test this per Riverty connection by placing a rejected order:
Go to the webshop, and place a product in the shopping cart.
Go to checkout and fill in the necessary information, for the email address you have to enter email@example.com.
Choose the payment method Riverty and finish the order.
The Riverty order should be rejected. If this is not the case and instead you receive a technical error or an authorization error please contact your Riverty Implementation Manager.
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.
Introduction to the Riverty Merchant Portal
You can go to the Merchant Portal here. Once logged in, you will also see an in-depth guide on how to best use it.
In the merchant portal you can:
- View and mutate your Riverty orders
- Get financial reports
- Setup your branding in the Riverty systems