Skip to content

Usage

  1. The customer chooses Riverty at checkout, enters what Riverty needs for the country (private or company, date of birth, phone, national identity number in the Nordics, company data for B2B), accepts Riverty’s terms and privacy sentence and is sent to Riverty’s hosted page where identity checks happen when Riverty asks for them.
  2. Riverty accepts and reserves the amount (nothing is owed yet): the order moves to the status you chose (default Open). If Riverty declines, the customer returns to the checkout with Riverty’s message and can pick another payment method. If the customer never returns, the cron run reads pending authorizations back (a pending authorization is not a decline; it expires after 15 minutes at Riverty).
  3. When the order reaches the capture status (default Complete), Riverty turns the reservation into the invoice and sends it to the customer. Use the Riverty payment tab of the order to capture earlier or only part of the order: choose the items and quantities that ship, the rest stays reserved (a reservation lapses after 30 days).
  4. If an order is canceled before shipping, Void reservation (or the Canceled status) releases it. Once an invoice exists a void is impossible: refund instead.
  5. Refund on the same tab: pick the returned items, or enter an amount (it becomes one refund line), or use Refund everything left. A refund always belongs to one invoice. Each refund gets a credit note number. Return costs are a separate negative line on Riverty’s side; enter the net amount you refund.

Every capture, void and refund is sent once: the request key is stored before the call, and when an answer is lost the add-on reads the order back from Riverty before it decides anything. An operation that shows Unconfirmed is being checked; the cron run settles it.

Area Meaning
Status Pending at Riverty, Authorized (reserved), Partly captured, Captured (invoiced), Partly refunded, Refunded, Failed, Canceled, Expired
Amounts Authorized, captured, voided, refunded and still reserved; the date the reservation lapses
Operations Every capture, void and refund with its reference number and state; captures made in the Riverty merchant portal appear as “Riverty portal” and can be refunded here
Message of Riverty Riverty’s own text for the customer when it declined
  • Jobs: counts per state, the list with the last error, Retry, Remove and Run the queue now.
  • Log: filter and export what happened and when (no buyer personal data is stored).
  • Connection: test and live keys per country, Test connection, merchant ID, webhook URL.

In owner mode the marketplace owner is the seller of record: the whole cart is authorized once; when a vendor moves its own order to the capture status, only that vendor’s lines are captured, so Riverty invoices each delivery separately. Refunds of one vendor’s order are limited to that order’s share of the payment. Vendors can see the tab of their own orders but cannot capture, void or refund in owner mode.