Gestione dei clienti

Una corretta gestione dei clienti non è solo una best practice tecnica, ma è anche essenziale per migliorare l'esperienza utente, semplificare le operazioni e favorire il successo del business.

Questa guida spiega come e perché utilizzare i clienti registrati con Voucherly.

Guida allo sviluppo

1. Prepara la richiesta

Primo pagamento

Quando crei un pagamento, includi i dettagli del cliente.

Esempio di richiesta

{
    "mode": "Payment",
    [...]
    "customerEmail": "mario.rossi@voucherly.it",
    "customerFirstName": "Mario",
    "customerLastName": "Rossi",
    [...]
}

Pagamento successivo

Prima di creare un pagamento, recupera il customerId di Voucherly. Poi includilo nel payload della richiesta per garantire una corretta elaborazione.

Esempio di richiesta

{
    "mode": "Payment",
    [...]
    "customerId": "my-customer-id-1",
    [...]
}

Puoi anche passare i dettagli del cliente per aggiornarli.

Esempio di richiesta

{
    "mode": "Payment",
    [...]
    "customerId": "my-customer-id-1",
    "customerEmail": "mario.rossi@voucherly.it",
    "customerFirstName": "Mario Luigi",
    "customerLastName": "Rossi",
    [...]
}

2. Gestisci la risposta

Esempio di risposta

{
    "id": "my-payment-id-1",
    "tenant": "live",
    "mode": "Payment",
    "customerId": "my-customer-id-1",
    [...]
    "checkoutUrl": "https://example.voucherly.it/checkout",
    "status": "Requested",
    [...]
}

Primo pagamento

Se non hai fornito un customerId nella richiesta iniziale, dovresti:

• Estrarre il customerId dalla risposta.
• Salvarlo nel tuo database.
• Includerlo nelle richieste successive per lo stesso cliente.

Pagamento successivo

Poiché hai fornito un customerId nella richiesta iniziale, il pagamento farà automaticamente riferimento al Customer esistente corrispondente.

Non è richiesta alcuna ulteriore azione da parte tua.

Facoltativo

Recupera i metodi di pagamento del cliente

Perché? I vantaggi!

• Ottimizza il checkout.
  • Precompila i dettagli del cliente come nome ed email, riducendo l'inserimento manuale.
  • Salva le preferenze e i metodi di pagamento del cliente per checkout futuri più rapidi.
  • Riduci gli attriti. Ad esempio, gateway di pagamento come Edenred utilizzano il Single Sign-On (SSO). Voucherly può mantenere attive le sessioni, migliorando il flusso di acquisto.
• Riconciliazione semplificata. Associare ogni pagamento a un cliente consente un tracciamento chiaro delle transazioni. Questo è particolarmente utile per gestire i rimborsi, l'analisi delle vendite e le verifiche contabili.