Settings
Open Add-ons > Manage add-ons > Riverty for CS-Cart and Multi-Vendor > Settings.
General
Section titled “General”| Setting | Default | Description |
|---|---|---|
| Enable | On | When off, no new payments are started. Jobs and webhooks of work that is already under way are still processed. |
| Marketplace owner mode | On | On: every order is processed with the marketplace owner’s account and vendors have no connection page. Off: each vendor connects their own account. |
| Debug log | Off | Also stores every HTTP call with masked request and response. Keys, birth dates, identity numbers, phone numbers and e-mail addresses are never stored. |
| Log retention (days) | 90 | Older log entries are removed by the cron run. |
| Order status when Riverty accepts | Open | The authorization was accepted (a reservation; nothing is owed yet). An incomplete order moves to this status; an order you already moved on keeps its status. |
| Order status when Riverty declines | Failed | Riverty rejected the risk check, or the authorization never arrived. Only an incomplete order is moved. |
| Order status when the payment is canceled | Canceled | A payment that was never accepted is canceled or expires. |
| Capture when the order status becomes | Complete | Riverty turns the reservation into the invoice and sends it to the customer. Empty = capture by hand. |
| Void the reservation when the order status becomes | Canceled | Releases a reservation that was not captured. Riverty cannot void an order that has an invoice (error 400.129): refund it instead. Empty = void by hand. |
| Refund when the order status becomes | empty | Refunds everything that is left of the captured invoice(s). Empty = refund by hand. |
| Send tracking numbers | On | The carrier and tracking number of the first shipment go to Riverty with the capture. |
| Show the Riverty badge at checkout | On | The badge is loaded from Riverty’s own CDN as Riverty requires (never copied to your server). Off = no request to an outside host. |
Connection
Section titled “Connection”Credentials are entered on the Connection page and stored encrypted (AES-256-GCM, key derived from your store’s own secret). They are never shown again (a hint of the last four characters is shown); leave a field empty to keep the saved value, tick “remove” to delete one key.
| Field | Description |
|---|---|
| Mode | Test uses the test keys and Riverty’s Partner Test environment (api.bnpl-pt.riverty.io); Live uses the live keys and api.bnpl.riverty.io. |
| Key per country | The X-Auth-Key Riverty issued for your web shop and that country (Germany EUR, Austria EUR, Netherlands EUR, Belgium EUR, Finland EUR, Switzerland CHF, Sweden SEK, Norway NOK, Denmark DKK). A country without a key does not show the method. |
| Webhook secret | The shared secret for Riverty’s checkout events (test and live differ). Events are optional; the add-on reads the order back from Riverty anyway. |
| Riverty merchant ID | Needed in the terms links of Sweden, Norway, Finland, Denmark and Belgium (Dutch). |
| Order number prefix | Optional. Riverty never accepts an order number twice per key. |
Payment method (Administration > Payment methods)
Section titled “Payment method (Administration > Payment methods)”| Option | Description |
|---|---|
| Riverty payment type | Invoice (14 / 30 days, DE AT CH NL BE and the Nordics): the verified type. The other choices (invoice with direct debit DE AT NL, instalments DE AT SE NO FI DK, Pay in 3 NL, Riverty’s selection page) are labelled “not verified – needs Riverty confirmation” and stay hidden at checkout until Enable payment types not verified with Riverty is on. |
| Instalment profile number | Instalments only: the profile number Riverty gave you (payment.installment.profileNo). Without it the instalment method is not offered. |
Direct debit, instalments, Pay in 3 and Riverty’s selection page are built from Riverty’s API reference but are not verified with Riverty yet: they are off by default, labelled “not verified – needs Riverty confirmation” and should only be switched on (Enable payment types not verified with Riverty) after your Riverty integration manager confirmed them for your contract in the Partner Test environment. Instalments and Pay in 3 additionally need Riverty’s confirmation of its checkout rules for credit products that apply from 20 November 2026 (see the FAQ).
The method is offered only when the billing country has a key, the country and currency pair is one Riverty serves for that type (for example EUR for Germany, CHF for Switzerland, SEK for Sweden) and the add-on is licensed and not paused. B2B (company invoice) is offered for Germany, Austria and the Netherlands.
The queue runs from cron. Use either the command line or the secret web address shown in the Cron section of the settings:
php /path/to/store/admin.php --dispatch=kv_riverty.cronhttps://your-store.example/index.php?dispatch=kv_riverty.cron&key=<secret>
Log and jobs
Section titled “Log and jobs”- Log lists every call, job and webhook with filters (level, action, text, dates) and a CSV export.
- Jobs lists the queue. A job that fails is retried after 5 minutes, 15 minutes, 1 hour, 3 hours and 12 hours, then marked “Gave up”; use Retry to queue it again.
Multi-Vendor
Section titled “Multi-Vendor”In the vendor panel a vendor sees only their own records. In owner mode vendors may look and refresh but not capture, void or refund; they trigger the capture of their own lines by moving their order to the capture status. With the owner mode off the vendor also gets the Connection tab for their own account.