Waarom het werkt

Wat je krijgt

Van saldo naar saldo, meteen

Heeft de ontvanger ook een Rox Pay wallet, dan gaat het geld rechtstreeks van het ene saldo naar het andere en is het direct beschikbaar.

Zie wie je betaalt

Voer de code in of zoek op naam: Rox Pay toont de naam van de ontvanger en vraagt om bevestiging voordat er geld wordt verplaatst.

Aan beide kanten vastgelegd

Elke overboeking verschijnt in de mutaties van verzender en ontvanger, met tegenpartij, code, omschrijving en saldo voor en na.

Waar je het gebruikt

Via het dashboard, de kaart of je eigen software

Dashboard

Geld versturen

Zoek een bedrijf of persoon op naam, of plak de code. Kies het saldo, het bedrag en een omschrijving en bevestig.

Ontvangen

De code van je bedrijf

Elke wallet heeft een code (CMP- voor bedrijven, USR- voor personen). Kopieer en deel hem: wie hem gebruikt, stuurt geld rechtstreeks naar je wallet.

Kaart

Kaart met verkopers

Vind bedrijven die Rox Pay accepteren en stuur geld direct vanuit de kaart van de verkoper. Of een bedrijf op de kaart staat, kiest het zelf.

API

REST API v5

Twee endpoints om overboekingen te versturen en op te vragen vanuit je software, met idempotentiesleutel, foutcodes en geplande overboekingen.

Hoe het werkt

Een overboeking in vier stappen

Het geld gaat niet via een kaart of bankoverschrijving: het beweegt tussen twee Rox Pay saldi. Vóór elke verzending controleert het platform de ontvanger, het saldo en de limieten.

  • Vind de ontvanger: zoek een bedrijf of persoon op naam, of voer de CMP- of USR-code in.
  • Controleer: Rox Pay herkent de code en toont de geregistreerde naam. Inactieve wallets en overboekingen naar jezelf worden geblokkeerd.
  • Verstuur: kies het saldo (EUR of een andere walletvaluta), het bedrag en eventueel een omschrijving en bevestig.
  • Bijgeschreven: het geld staat meteen op het saldo van de ontvanger en de overboeking verschijnt in beide historieën.
  • Onherroepelijk: eenmaal bevestigd kan een overboeking niet worden geannuleerd. Daarom komt de controle eerst.
Je saldo wordt vóór het versturen gecontroleerd: is het besteedbare saldo niet toereikend, dan gaat de overboeking niet door.
  1. 1 Vinden Naam of code
  2. 2 Controleren Naam bevestigd
  3. 3 Versturen Bedrag en omschrijving
  4. 4 Bijgeschreven Meteen op het saldo
Mutaties van de verzender
Werkplaats Rossi B.V. Uitgaand · Factuur 2026/118 −€ 250,00
Mutaties van de ontvanger
Studio Bianchi Inkomend · Factuur 2026/118 +€ 250,00
Ontvanger gecontroleerd · Saldo gecontroleerd · Onherroepelijk
Functies

Wat erin zit, in detail

Gecontroleerde ontvanger

De code wordt vóór verzending op de server herkend. Aparte foutmeldingen voor een ongeldige code, een onbekende ontvanger of een wallet die nog niet actief is.

Saldi in meerdere valuta

Kies vanuit welk walletsaldo je verstuurt. Heb je geen saldo in de gevraagde valuta, dan wordt de overboeking geweigerd voordat er geld beweegt.

Geplande overboekingen

Via de API kun je een toekomstige datum opgeven (tijdzone Europe/Rome). De overboeking blijft in afwachting en het saldo wordt op de uitvoeringsdag gecontroleerd.

Idempotency-Key

Stuur een Idempotency-Key-header mee en herhaal de aanroep veilig: dezelfde sleutel verplaatst nooit twee keer geld.

Historie met filters

Inkomende en uitgaande mutaties filteren op richting, datum, bedrag en vrije tekst, met de status van de overboeking en saldo voor en na.

Machineleesbare fouten

Elke weigering geeft een ErrorCode terug (bijvoorbeeld INSUFFICIENT_BALANCE of SELF_TRANSFER), zodat je software kan reageren zonder tekst te ontleden.

Wallet en bankrekening

Tussen wallets, naar de bank of inkomend: voor elke beweging het juiste middel

Een overboeking tussen wallets is de snelste manier om iemand te betalen die al Rox Pay gebruikt. Om geld naar je bankrekening te brengen of je wallet op te waarderen zijn er aparte middelen, in hetzelfde dashboard en dezelfde API.

Wallet → Wallet

Overboeking tussen wallets

Naar een ander bedrijf of persoon met een Rox Pay wallet. Direct bijgeschreven op het saldo, € 1 tot € 5.000 per overboeking, gecontroleerde ontvanger.

Wallet → IBAN

Opname naar je bankrekening

Zet je beschikbare saldo over naar een gekoppelde bankrekening wanneer je wilt, of met automatische uitbetaling. De geldende uitbetalingskosten worden in rekening gebracht.

Opwaarderen

Wallet opwaarderen

Voeg geld toe aan je EUR-saldo met een betaling vanaf je bankrekening (pay by bank) of met een geverifieerde kaart die in de wallet is opgeslagen.

Wil je weten welke flow bij jouw betalingen past? We bespreken het graag.

Praat met ons
Controles

De controles die voor elke overboeking gelden

De regels zijn in het dashboard en in de API hetzelfde: één controlepunt voor bedragen, ontvanger en saldo.

Alleen vanuit je eigen wallet

Niemand verstuurt namens anderen, ook partners en beheerders niet

Ontvanger gecontroleerd

Code herkend, wallet actief, geen overboekingen naar jezelf

Besteedbaar saldo

Beschikbaar min reserves, gecontroleerd vóór verzending

Geen dubbele verzending

Idempotency-Key bij elke API-aanroep

Voor ontwikkelaars

Twee endpoints, één overboeking

Authenticatie met Bearer-token, bedragen in centen, JSON-antwoorden met leesbare ErrorCode. De verzendende wallet is altijd die van het bedrijf waartoe het token behoort.

POST /api/v5/wallet/transfer
Verzoek
Authorization: Bearer <token>
Idempotency-Key: "inv-2026-118"

{
  "BeneficiaryCode": "CMP-20260121-037118B5BFCB",
  "Amount": 25000,
  "Currency": "EUR",
  "Purpose": "Factuur 2026/118"
}
Antwoord · 200
{
  "Result": true,
  "Message": "Transfer executed successfully.",
  "Recipient": { "Type": "company", "DisplayName": "…" }
}
Beschikbare endpoints
POST /api/v5/wallet/transfer Een overboeking versturen of inplannen

BeneficiaryCode, Amount in centen, optioneel Currency en Purpose. Met OperationDate wordt de overboeking alleen vastgelegd en op de opgegeven datum uitgevoerd.

Idempotency-KeyGeplande overboekingenLeesbare ErrorCode
GET /api/v5/wallet/transfers Inkomende en uitgaande overboekingen opvragen

Filters op richting, periode, minimum- en maximumbedrag en vrije tekst. Paginering tot 100 regels, saldo voor en na bij elke overboeking.

Direction incoming / outgoingFilters op datum en bedragSaldo voor en na
Toepassingen

Wie het gebruikt, en waarvoor

Leveranciers en partners op Rox Pay betalen

Betaal een leverancier of partner die al een Rox Pay wallet heeft: geen IBAN overtikken, naam gecontroleerd, omschrijving bewaard in de historie.

Terugbetalingen en betalingen aan personen

Stuur geld naar de persoonlijke wallet (USR-) van medewerkers, freelancers of klanten, bijvoorbeeld voor een onkostenvergoeding.

Meerdere bedrijven, één login

Beheer je meerdere bedrijven op Rox Pay, dan verplaats je met een paar klikken geld tussen hun wallets, elk met een eigen historie.

Automatische betalingen vanuit je software

Je software roept de API aan om overboekingen te versturen of in te plannen en leest de historie om de administratie bij te werken.

Betaal Rox Pay-gebruikers in een oogwenk.

Activeer overboekingen tussen wallets voor je bedrijf of bouw ze met de API in je software in.

Veelgestelde vragen over overboekingen tussen wallets

Vind antwoorden op veelgestelde vragen