Perché funziona

Cosa ottieni

Da saldo a saldo, subito

Se anche il destinatario ha un wallet Rox Pay, i fondi passano direttamente da un saldo all'altro e sono subito disponibili.

Vedi a chi stai pagando

Inserisci il codice o cerca per nome: Rox Pay ti mostra il nome del destinatario e chiede conferma prima di muovere il denaro.

Tracciato su entrambi i lati

Ogni trasferimento compare nei movimenti di chi invia e di chi riceve, con controparte, codice, causale e saldo prima e dopo.

Dove lo usi

Dalla dashboard, dalla mappa o dal tuo software

Dashboard

Invia denaro

Cerchi un'azienda o una persona per nome, oppure incolli il suo codice. Scegli il saldo da usare, l'importo e una causale, poi confermi.

Ricevi

Il codice della tua azienda

Ogni wallet ha un codice (CMP- per le aziende, USR- per le persone). Lo copi e lo condividi: chi lo usa ti invia denaro direttamente sul wallet.

Mappa

Mappa degli esercenti

Trova le attività che accettano Rox Pay e invia denaro direttamente dalla scheda dell'esercente. Comparire sulla mappa è una scelta di ogni attività.

API

API REST v5

Due endpoint per inviare e consultare i trasferimenti dal tuo gestionale, con chiave di idempotenza, codici di errore e trasferimenti programmati.

Come funziona

Un trasferimento in quattro passaggi

Il denaro non passa da una carta né da un bonifico verso la banca: si sposta tra due saldi Rox Pay. Prima di ogni invio la piattaforma controlla il destinatario, il saldo e i limiti.

  • Trova il destinatario: cerca un'azienda o una persona per nome, oppure inserisci il suo codice CMP- o USR-.
  • Verifica: Rox Pay risolve il codice e ti mostra il nome registrato. Wallet non attivi e invii a te stesso vengono bloccati.
  • Invia: scegli il saldo (EUR o un'altra valuta del wallet), l'importo e una causale facoltativa, poi confermi.
  • Accreditato: i fondi sono subito sul saldo del destinatario e il trasferimento compare nei movimenti di entrambi.
  • Irrevocabile: una volta confermato, il trasferimento non si può annullare. Per questo la verifica viene prima.
Il saldo viene controllato prima dell'invio: se i fondi spendibili non bastano, il trasferimento non parte.
  1. 1 Trova Nome o codice
  2. 2 Verifica Nome confermato
  3. 3 Invia Importo e causale
  4. 4 Accreditato Subito sul saldo
Movimenti di chi invia
Bottega Rossi S.r.l. Uscita · Fattura 2026/118 −250,00 €
Movimenti di chi riceve
Studio Bianchi Entrata · Fattura 2026/118 +250,00 €
Destinatario verificato · Saldo controllato · Irrevocabile
Funzionalità

Cosa c'è dentro, nel dettaglio

Destinatario verificato

Il codice viene risolto lato server prima dell'invio. Errori specifici per codice non valido, destinatario inesistente o wallet non ancora attivo.

Saldi multi-valuta

Scegli da quale saldo del wallet inviare. Se non hai un saldo nella valuta indicata, il trasferimento viene rifiutato prima di muovere denaro.

Trasferimenti programmati

Via API puoi indicare una data futura (fuso Europe/Rome). Il trasferimento resta in attesa e il saldo viene controllato il giorno dell'esecuzione.

Idempotency-Key

Invia un header Idempotency-Key e ripeti la chiamata in sicurezza: la stessa chiave non sposta mai denaro due volte.

Storico con filtri

Movimenti in entrata e in uscita filtrabili per direzione, data, importo e testo libero, con stato del trasferimento e saldo prima e dopo.

Errori leggibili dal codice

Ogni rifiuto restituisce un ErrorCode (ad esempio INSUFFICIENT_BALANCE o SELF_TRANSFER), così il tuo software reagisce senza interpretare testi.

Wallet e conto bancario

Tra wallet, verso la banca o in entrata: ogni movimento ha il suo strumento

Il trasferimento tra wallet è il modo più rapido per pagare chi usa già Rox Pay. Per portare i fondi sul conto bancario o per ricaricare il wallet ci sono strumenti dedicati, sempre dalla stessa dashboard e dalle stesse API.

Wallet → Wallet

Trasferimento tra wallet

Verso un'altra azienda o persona con wallet Rox Pay. Accredito immediato sul saldo, da 1 € a 5.000 € per trasferimento, destinatario verificato.

Wallet → IBAN

Prelievo sul conto bancario

Trasferisci il saldo disponibile su un conto bancario collegato, quando vuoi o con il prelievo automatico. Si applica la commissione di prelievo prevista.

Ricarica

Ricarica del wallet

Aggiungi fondi al saldo in EUR con un pagamento dal conto bancario (pay by bank) o con una carta verificata salvata nel wallet.

Vuoi capire quale flusso si adatta ai tuoi pagamenti? Ne parliamo con te.

Parla con noi
Controlli

I controlli che valgono per ogni trasferimento

Le regole sono le stesse dalla dashboard e dalle API: un unico punto di controllo per importi, destinatario e saldo.

Solo dal proprio wallet

Nessuno invia per conto di terzi, nemmeno partner o amministratori

Destinatario controllato

Codice risolto, wallet attivo, niente invii a se stessi

Saldo spendibile

Disponibile al netto delle riserve, verificato prima dell'invio

Nessun doppio invio

Idempotency-Key su ogni chiamata API

Per sviluppatori

Due endpoint, un trasferimento

Autenticazione con token Bearer, importi in centesimi, risposte JSON con ErrorCode leggibile. Il wallet che invia è sempre quello dell'azienda a cui appartiene il token.

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

{
  "BeneficiaryCode": "CMP-20260121-037118B5BFCB",
  "Amount": 25000,
  "Currency": "EUR",
  "Purpose": "Fattura 2026/118"
}
Risposta · 200
{
  "Result": true,
  "Message": "Transfer executed successfully.",
  "Recipient": { "Type": "company", "DisplayName": "…" }
}
Endpoint disponibili
POST /api/v5/wallet/transfer Invia o programma un trasferimento

BeneficiaryCode, Amount in centesimi, Currency e Purpose facoltativi. Con OperationDate il trasferimento viene solo prenotato ed eseguito alla data indicata.

Idempotency-KeyTrasferimenti programmatiErrorCode leggibili
GET /api/v5/wallet/transfers Elenca i trasferimenti in entrata e in uscita

Filtri per direzione, intervallo di date, importo minimo e massimo e testo libero. Paginazione fino a 100 righe, saldi prima e dopo per ogni trasferimento.

Direction incoming / outgoingFiltri data e importoSaldo prima e dopo
Casi d'uso

Chi lo usa, e per cosa

Pagare fornitori e partner su Rox Pay

Saldi un fornitore o un partner che ha già un wallet Rox Pay: niente IBAN da copiare, il nome è verificato e la causale resta nello storico.

Rimborsi e pagamenti a persone

Invii denaro al wallet personale (USR-) di collaboratori, dipendenti o clienti, ad esempio per un rimborso spese.

Più società, un solo login

Se gestisci più aziende su Rox Pay, sposti fondi tra i loro wallet in pochi clic, ognuna con il proprio storico.

Pagamenti automatici dal gestionale

Il tuo software chiama l'API per inviare o programmare trasferimenti e legge lo storico per aggiornare le registrazioni.

Paga chi usa Rox Pay in un attimo.

Attiva i trasferimenti tra wallet per la tua azienda o integrali nel tuo software con le API.

Domande frequenti sui trasferimenti tra wallet

Trova risposte alle domande più frequenti