I nostri terminali possono essere collegati ai distributori automatici tramite il bus MDB. Questo articolo spiega come funziona l'integrazione, quali comportamenti vengono negoziati automaticamente, cosa è possibile configurare durante il onboarding e cosa è supportato oggi.
Come funziona l'integrazione
Il terminale opera in modalità MDB Slave e si collega al Controller del Distributore Automatico (VMC) utilizzando il protocollo MDB v4.3. L'hardware principale è l'IM30, che dispone di una porta fisica MDB Slave. In questa configurazione il distributore automatico è il master e il terminale agisce come periferica cashless: il VMC richiede un pagamento, Pay On Site lo elabora e il risultato viene restituito al VMC, che quindi eroga il prodotto.
Ad ogni connessione, il terminale e il VMC negoziano automaticamente due aspetti: il livello massimo di comando supportato da entrambe le parti e la modalità di comportamento del lettore. Questi non vengono impostati sul terminale.
Livelli di funzionalità
MDB definisce tre livelli di funzionalità cashless. Il livello viene negoziato tra la macchina e il terminale al momento della connessione — non è qualcosa che si configura manualmente. Nei test, un terminale che pubblicizzava il Livello 3 funzionava correttamente con macchine di Livello 1 e Livello 2, adottando automaticamente il livello della macchina.
| Livello | Comportamento |
|---|---|
| Livello 1 | Pagamento cashless base — un singolo prodotto, prezzo esatto noto |
| Livello 2 | Vendita basata su sessione — viene condiviso un importo massimo, singolo prodotto |
| Livello 3 | Multi-vendita — viene condiviso un importo massimo, il cliente seleziona più prodotti fino al raggiungimento del limite |
Nota
Il livello viene negoziato automaticamente. Il terminale si adatta a qualunque livello presenti il distributore automatico.
Modalità di comportamento del lettore
Oltre al livello, il terminale e il VMC concordano quando il lettore contactless diventa attivo:
- Always Idle — il lettore è sempre acceso. Il cliente avvicina la carta per primo, poi seleziona un prodotto.
- Button First — il lettore si attiva solo dopo che il cliente ha selezionato un prodotto.
Cosa configurare durante il onboarding
L'app "MDB App" di Market Pay deve essere aggiunta sul dispositivo, insieme al protocollo "MDB slave" durante il onboarding.
La maggior parte dei parametri viene negoziata automaticamente o ereditata dal record del commerciante piuttosto che impostata per ogni terminale. La tabella sottostante riassume cosa esporre.
| Parametro | Dove si trova | Esponi durante il onboarding? |
|---|---|---|
| Livello di funzionalità (L1/L2/L3) | Negoziazione automatica con la macchina | No — non è consigliato sovrascrivere |
| Multi-vendita | Configurazione terminale / gruppo | No — è meglio mantenerlo nascosto (vedi limitazioni) |
| Paese, valuta, lingue | Gestito, collegato al commerciante | No — ereditato dal commerciante |
| Schemi | Gestito, collegato al commerciante | No — ereditato; determina i loghi visualizzati |
| Modalità di pagamento (preselezione) | Comportamento fisso | No — oggi è supportata solo la preselezione |
Paese, valuta, lingue e schemi sono gestiti centralmente a livello di commerciante, quindi non necessitano di esposizione per ogni terminale. Gli schemi principalmente determinano quali loghi delle carte di pagamento vengono mostrati; è consigliabile gestirli allo stesso modo in Pay On Site per coerenza.
Modalità di pagamento: solo preselezione
Pay On Site supporta attualmente solo la modalità preselezione — il prezzo esatto è noto al momento dell'autorizzazione. Il cliente seleziona un prodotto (o più prodotti, fino al limite di sessione), il VMC invia l'importo finale, il terminale autorizza quell'importo esatto e il VMC eroga il prodotto.
Non esiste una modalità di preautorizzazione, in cui il terminale autorizzerebbe un importo massimo e successivamente acquisirebbe l'importo effettivo. Questo non è esposto come parametro perché non è supportato.
Affidabilità: vendite negative
Se un pagamento ha successo ma il VMC non riesce a erogare il prodotto, il flusso attiva una vendita negativa — un rimborso automatico — così che il cliente non venga addebitato per un prodotto non ricevuto.