GDO e grocery

Il checkout della spesa online, pronto per il grocery

Buoni pasto sul carrello misto, quota carta pre-autorizzata e catturata alla preparazione, eccedenze restituite da sole. Via API, senza sostituire i gateway in uso.

Documentazione API
Integrazione via API, qualunque sia la piattaforma: SAP Commerce, Magento o custom · Nessun gateway da sostituire · Contratti, settlement e dati restano dell'insegna
Ordine #71 402 · consegna domani 18–20
Spesa online · Milano Lambrate
Addebito differito
  1. Pre-autorizzazione al checkout
    Buoni pasto € 48,00 + carta € 38,40
    € 86,40
  2. Banana Chiquita · a peso
    Ordinato 1,00 kg · pesato 1,12 kg
    + € 0,29
  3. Petto di pollo · a peso
    Ordinato 600 g · pesato 548 g
    − € 0,62
  4. Yogurt greco 500 g
    Non disponibile in preparazione
    − € 2,49
  5. Addebito alla preparazione
    Buoni pasto € 48,00 · carta € 35,58 · € 2,82 mai addebitati
    € 83,58

Il cliente vede un solo movimento, pari alla spesa effettivamente consegnata. Nessuno storno da gestire.

Grocery, e-commerce alimentare e smart fridge che incassano con Voucherly
Il problema

Il grocery online non è un e-commerce come gli altri

L'importo cambia dopo il checkout, il carrello mescola alimentari e non, il cliente vuole pagare con metodi che online non esistono e i flussi finiscono in società diverse. Un gateway generico non lo sa; il team e-commerce finisce per gestirlo a mano.

  • L'importo si conosce solo dopo il picking

    Pesi variabili, sostituzioni e prodotti mancanti cambiano il totale dopo il checkout. Un gateway generico addebita subito e costringe a storni, doppi movimenti e ticket al servizio clienti.

  • Il carrello è misto per definizione

    Alimentari, detersivi, consegna e servizio nello stesso ordine. La quota spendibile con buoni pasto va calcolata riga per riga e il resto instradato altrove, senza che il team e-commerce scriva regole a mano.

  • Il buono pasto non si spende online

    Oltre 4 miliardi di euro l'anno accettati in cassa e raramente sull'e-commerce o sull'app. Emettitori diversi, buoni nominativi, limiti giornalieri: ogni integrazione diretta è un progetto a sé.

  • Soci, insegne e società da riconciliare

    Un solo checkout, ma flussi che finiscono in società diverse. Cassa, ODS e amministrazione devono sapere quanto è stato pagato con buoni, con carta e con credito wallet, per ogni punto vendita.

Il ciclo di vita dell'ordine grocery

Dalla scelta del metodo alla consegna, un solo pagamento

Cinque fasi, stati espliciti e nessuna operazione manuale tra il checkout e la cassa.

  1. 1

    Selezione del metodo

    La piattaforma e-commerce crea il pagamento via API passando le righe d'ordine, con l'indicazione di quali sono alimentari, la scadenza e l'oggetto store. Il cliente sceglie tra buoni pasto, carta, PayPal o wallet e vede i loghi degli emettitori attivi.

  2. 2

    Autorizzazione nel checkout Voucherly

    Per i buoni nominativi il cliente accede al proprio emettitore con SSO senza uscire dal checkout. Voucherly calcola la quota food, applica i limiti dell'emettitore, prenota i buoni e pre-autorizza il resto sulla carta, maggiorazione compresa. La callback server-to-server con l'esito arriva prima del redirect: il pagamento è Paid.

  3. 3

    Preparazione e picking

    Il merchant conferma l'ordine e lo prepara. Pesi variabili, sostituzioni e short pick cambiano l'importo, mentre carta e buoni restano prenotati. Se l'ordine non viene confermato entro la scadenza indicata, o dopo 12 ore, Voucherly annulla i buoni e svincola la carta da solo: stato Expired.

  4. 4

    Cattura dell'importo finale

    Con Confirm Payment la piattaforma comunica l'importo definitivo e le righe consegnate. Voucherly ricalcola la quota food, cattura sulla carta solo il dovuto e conferma i buoni necessari: stato Confirmed. Cassa e ODS ricevono l'ordine marcato prepagato con gli importi separati per metodo.

  5. 5

    Eccedenza restituita, rimborsi e modifiche

    I buoni non utilizzati tornano sul borsellino del cliente, la quota carta in eccesso viene svincolata. Per un rimborso o una modifica dell'ordine basta un comando: Voucherly decide tra void e refund per ogni transazione e storna il vecchio pagamento quando ne viene creato uno nuovo.

Carrello misto

La quota buoni pasto la calcola Voucherly, riga per riga

Alimentari, detersivi, consegna, servizio e maggiorazione convivono nello stesso ordine. La piattaforma indica quali righe sono alimentari e passa gli sconti; Voucherly somma le righe alimentari, applica i limiti degli emettitori e ripartisce il pagamento tra buoni pasto e carta.

  • Ogni riga d'ordine è marcata come alimentare o no: Voucherly somma le righe alimentari e ottiene la quota pagabile con buoni pasto
  • Non food, spese di consegna, servizio, mance e maggiorazione vengono instradati su carta, PayPal o wallet nello stesso pagamento
  • Gli sconti a prodotto e a carrello sono supportati: lo sconto a carrello viene distribuito sulle righe prima del calcolo della quota
  • Il merchant non implementa limiti né regole degli emettitori: la piattaforma passa le righe, Voucherly applica le regole
Carrello · spesa online
Totale € 40,13
Prodotti ammessi per riga
  • food
    Petto di pollo · a peso
    circa 600 g
    € 6,90
  • food
    Frutta e verdura
    5 articoli
    € 9,40
  • food
    Latte, yogurt e pane
    4 articoli
    € 11,70
  • non food
    Detersivo piatti 1 l
    1 articolo
    € 3,49
  • non food
    Carta igienica 8 rotoli
    1 articolo
    € 4,20
  • non food
    Consegna a domicilio
    fascia 18–20
    € 2,90
  • non food
    Maggiorazione
    peso variabile · pre-autorizzata, svincolata alla cattura
    € 1,54
Buoni pasto
€ 28,00
Somma delle righe food, calcolata da Voucherly
Carta •••• 4242
€ 12,13
Non food, consegna e maggiorazione
Funzionalità

Quello che il team IT si aspetta di trovare nell'API

Dodici funzionalità pensate per chi integra il pagamento nella piattaforma e-commerce e nell'app della GDO, documentate e provabili in sandbox.

  • Prodotti ammessi, riga per riga

    La quota buoni pasto è la somma delle righe alimentari, calcolata da Voucherly. Spedizione, servizio e non food vanno sugli altri metodi.

  • Limiti degli emettitori gestiti

    Limiti giornalieri e per transazione di ogni emettitore, fino a 8 buoni per legge, applicati da Voucherly. Nessuna regola da scrivere lato merchant.

  • Sconti a prodotto e a carrello

    Lo sconto a prodotto riduce la riga; lo sconto a carrello viene distribuito sulle righe prima del calcolo della quota food.

  • Pre-autorizzazione e Confirm Payment

    Quota carta pre-autorizzata al checkout con maggiorazione; importo finale catturato alla preparazione per pesi variabili, sostituzioni e short pick.

  • Callback S2S sincrona

    L'esito arriva server-to-server prima del redirect del cliente. Se il merchant non conferma l'ordine, Voucherly annulla e rimborsa da solo.

  • customerId e borsellino

    Un identificativo persistente per cliente: borsellino con i residui dei buoni, storico e metodi salvati (solo carte, mai buoni pasto).

  • Configurazioni per socio, insegna e punto vendita

    Ogni pagamento porta un oggetto store con socio, insegna e punto vendita: la base per customer care, rendicontazione e fatturazione separata.

  • Stati chiari e buoni con scadenza

    Requested, Paid, Confirmed, Expired. I buoni prenotati vengono annullati alla scadenza indicata dal merchant o dopo 12 ore, senza intervento.

  • Un solo comando di rimborso

    Rimborso totale o parziale su Paid o Confirmed con una sola chiamata: Voucherly sceglie tra void e refund per ogni transazione, buoni compresi.

  • Dati per cassa e ODS

    Importo pagato con buoni, con carta e con credito wallet, separati e disponibili via API e webhook. L'ordine arriva in cassa marcato prepagato.

  • SSO e loghi degli emettitori

    Login del cliente presso l'emettitore dentro il checkout Voucherly. I loghi degli emettitori attivi sono visibili prima della scelta: il cliente riconosce il suo emettitore e non deve conoscere Voucherly.

  • Sandbox, customer care e SLA

    Ambiente sandbox con emettitori simulati, dashboard di customer care per cercare i pagamenti per ordine, cliente o store, SLA contrattuali con uptime misurato.

Contenuti per il cliente finale

Cosa mostrare in thank you page, dettaglio ordine ed email

Un pagamento misto con importo variabile va spiegato. Voucherly espone via API i dati da mostrare al cliente, così l'insegna evita la chiamata al servizio clienti che chiede perché sulla carta compare un importo diverso.

  • Importo pagato con buoni pasto e importo pre-autorizzato sulla carta, separati e con l'indicazione della maggiorazione
  • Metodo di pagamento composito (buoni pasto + carta) leggibile in thank you page, dettaglio ordine ed email di conferma
  • Spiegazione dell'eccedenza: cosa viene svincolato sulla carta e cosa torna sul borsellino, prima che il cliente chiami il servizio clienti
  • Importo definitivo dopo la cattura, con lo scontrino digitale via email o SMS e la richiesta fattura in un click
Thank you pageDettaglio ordineEmail di conferma
Ordine #71 418 confermato
Consegna domani, fascia 18–20 · Metodo: buoni pasto + carta
  • Importo pagato con buoni pasto
    Pluxee · quota alimentare dell'ordine
    € 28,00
  • Importo preautorizzato sulla carta
    Include € 1,54 di maggiorazione per i prodotti a peso
    € 12,13
Sulla carta verrà addebitato solo l'importo dei prodotti effettivamente consegnati. La differenza viene svincolata automaticamente; i buoni pasto non utilizzati tornano sul tuo borsellino.
Fiscalizzazione e compliance

Scontrino, reso e fattura, con i ruoli chiari

Ogni cattura genera il documento commerciale verso l'Agenzia delle Entrate, ogni rimborso il documento di reso. Il cliente chiede la fattura in un click. Voucherly opera come proxy tecnico e responsabile del trattamento: contratti, settlement e dati restano dell'insegna.

  • Documento commerciale online emesso con integrazione diretta all'Agenzia delle Entrate, senza registratore telematico
  • Documento commerciale di reso emesso automaticamente su ogni rimborso, totale o parziale
  • Richiesta fattura dal cliente in un click dalla pagina di esito o dallo scontrino digitale, dati fiscali raccolti da Voucherly
  • Voucherly è responsabile del trattamento (DPA); il merchant resta titolare di dati, contratti e settlement
  • La classificazione food dei prodotti resta al merchant, con il supporto di Voucherly sui casi dubbi
Rimborso ordine #48213
Automatico
  1. Richiesta di storno
    € 22,50 · pagamento misto buono + carta
  2. Quota buono pasto → borsellino
    € 10,00 accreditati sul wallet del cliente
  3. Quota carta → gateway
    € 12,50 stornati su Nexi
  4. Documento commerciale di reso
    Emesso verso l'Agenzia delle Entrate
Riconciliazione

Ogni euro separato per metodo, insegna e società

Finance vede quanto è stato incassato con carte, con ogni emettitore di buoni pasto, con PayPal e con il borsellino, per socio, insegna e punto vendita, in un solo report.

  • Righe separate per metodo: carte, ogni emettitore di buoni pasto, PayPal, wallet e borsellino
  • Filtri e report per socio, insegna, punto vendita e società, dall'oggetto store del pagamento
  • Report per emettitore pronto per il confronto con le liquidazioni
  • Export CSV ed Excel, webhook e API per l'ERP e gli strumenti di finance
Riconciliazione · settimana 36
Spesa online · Insegna Nord · Società A
CSV · Excel · API
MetodoLordoCommissioniNetto
Carte (Adyen)€ 142.300,00€ 1.280,70€ 141.019,30
Edenred€ 38.640,00€ 1.932,00€ 36.708,00
Pluxee€ 27.910,00€ 1.395,50€ 26.514,50
PayPal€ 9.360,00€ 318,24€ 9.041,76
Borsellino€ 4.120,00€ 0,00€ 4.120,00
Totale€ 222.330,00€ 4.926,44€ 217.403,56
Ecosistema

Emettitori, gateway e wallet già integrati

Tutti i principali emettitori di buoni pasto, i PSP e i wallet che l'insegna usa già. Nessun contratto da rifare, nessun lock-in.

Domande frequenti

Hai ancora delle domande?

Le domande che ci fanno i team IT, digital ed e-commerce della GDO prima di integrare Voucherly.

Non trovi la risposta? Parla con un nostro esperto.

Prenota una demo

Vuoi portare buoni pasto e cattura alla preparazione sulla tua spesa online?

Una call tecnica con il tuo team e-commerce e IT: piattaforma in uso, gateway, flussi di picking, soci e società da gestire.

  • Verifica dell'integrazione via API con la tua piattaforma e-commerce
  • Demo del flusso con carrello misto, pre-autorizzazione e Confirm Payment
  • Accesso alla sandbox e piano di pilota su un'insegna o una società

Bastano i tuoi dati e due informazioni sull'azienda. Al resto pensiamo durante la call.

Passo 1 di 2