Integrazione ImaCash

Certificazione POS con ImaCash API REST

Prepara la verifica del POS con ImaCash API REST: contanti, pagamenti misti, carte, annullamento, uscite e disponibilità, con risultati confermati.

Logo di ImaCash
Settore non specificato

Prepara la verifica tecnica del POS

Questa guida aiuta a preparare la verifica di un’integrazione tramite ImaCash API REST. Completare un elenco, usare il logo o ricevere una risposta HTTP non concede una certificazione né garantisce ogni combinazione di POS, macchina e versione.

Concorda prima ambito e ambiente di prova autorizzato con dati fittizi. L’amministratore fornisce indirizzo HTTPS del servizio e credenziale propria dell’installazione; mantienili privati. Segui il contratto della documentazione tecnica e non pubblicare chiavi in schermate, collegamenti o codice.

Sei verifiche del collegamento

  1. Vendita in contanti: invia solo l’importo pertinente e verifica riferimento, centesimi, segno, terminale, operatore, stato finale e contante reale. Creare una richiesta in attesa non equivale a un incasso completato.
  2. Vendita mista: separa contanti e carta. In questo percorso, invia a ImaCash solo la quota in contanti; POS e relativo gestore elaborano la carta. Verifica che le due quote corrispondano al totale senza duplicazioni.
  3. Vendita solo con carta: questo percorso del contante non deve richiedere movimenti di contante a ImaCash. Autorizzazione e conferma bancaria appartengono al POS e al relativo gestore.
  4. Annullamento: verifica prima lo stato del riferimento originale. Richiedere o registrare un annullamento non prova l’arresto di un’operazione già iniziata o la restituzione del contante. Confronta il risultato nei due programmi e nella macchina prima di chiudere la vendita.
  5. Uscite di contante e rimborsi: valida separatamente ogni modalità ammessa e il legame al documento originale. Conserva il segno di uscita e verifica l’importo effettivamente erogato; non presentare un rimborso parziale o incerto come completato.
  6. Disponibilità: distingui accesso HTTPS e autenticazione, lettura del riferimento e disponibilità di ImaCash e macchina. Un servizio raggiungibile non prova la capacità di erogazione. Verifica anche interruzioni e ripresa delle consultazioni senza richieste duplicate.

Identità, stati e limiti

Mantieni un riferimento univoco per operazione e il collegamento nel POS. L’API rifiuta riferimenti già registrati: se si perde una risposta, consulta lo stesso riferimento prima di ripetere. Non generare un altro riferimento per forzare un tentativo incerto.

Distingui richiesta registrata, operazione in attesa e risultato finale. Consulta stato e flusso di contante dello stesso riferimento; uno stato locale o l’importo richiesto non sostituisce conferma e tagli effettivamente ricevuti. Non dedurre un rimborso dal resto di una vendita.

Verifica incassi e uscite separatamente, inclusi zero, erogazione parziale ed errore. In caso di esito incerto, conserva il riferimento e coordina la verifica; non ripetere, risincronizzare o riavviare per dichiararlo concluso.

La verifica riguarda solo POS, versione, interfaccia, macchina e flussi espressamente concordati. Questa pagina non aggiunge un POS al catalogo né valida compatibilità fisica, certificazione automatica, prezzi, scadenze o autorizzazione a prove con clienti o denaro reale.

Documentazione tecnica ImaCash API REST

Richiedi una verifica coordinata

Indica software POS, società sviluppatrice, versione, interfaccia, dispositivo previsto e contatto. Fornisci risultati depurati dei sei casi, senza credenziali o dati dei clienti. Il team tecnico deve confermare espressamente ambito ed esito della verifica.

ImaCash

Coordina la verifica del POS

Contatta Imagina per concordare ambiente, flussi e prove necessarie prima dell’uso commerciale.