Per iniziare
Le istruzioni seguenti ti guideranno nell'integrazione della tua piattaforma con le nostre API.
Configurazione
1. Richiedi un account Sandbox
Richiedi un account a Voucherly dalla pagina Prenota una demo.
Quando l'account è creato, ricevi un'email per impostare la password. Il link vale 12 ore e conferma anche il tuo indirizzo email.
Poi accedi alla Dashboard.
Se lavori per un merchant che usa già Voucherly, chiedi invece al suo team di invitarti.
2. Ottieni le API keys
Nella sezione Sviluppatori troverai sia la secret key (chiave segreta) sia la publishable key (chiave pubblicabile).
Utilizza la secret key per autenticare le chiamate API, come spiegato in Autenticazione API.
La publishable key è pensata per il browser: inizializza i Voucherly Components, il modulo di pagamento incorporato nella tua pagina. Non può chiamare l'API.
3. Abilita i gateway di pagamento
Attiva i gateway di pagamento in Impostazioni > Pagamenti > Gateway di pagamento.
I pagamenti con buoni spesso richiedono un'integrazione con una transazione standard, come un pagamento con carta. Per questo motivo, si consiglia vivamente di attivare almeno un gateway di pagamento diverso dai buoni.
Per i test in sandbox, consigliamo di attivare Demo Voucherly e MultiSafepay. Sono sufficienti a replicare tutti i comportamenti di pagamento.
Per maggiori informazioni sui gateway di pagamento, consulta la risorsa Gateway di pagamento.
4. Iniziamo
Fai la tua prima chiamata API con il Quickstart, poi scegli l'integrazione più adatta a te in Pagamenti online:
- Plugin e-commerce — sviluppati internamente per PrestaShop, WooCommerce e Shopify, richiedono uno sforzo di sviluppo minimo o nullo e ti permettono di iniziare a testare da subito.
- Checkout ospitato — il tuo server crea un Payment e reindirizza il cliente a una pagina ospitata da Voucherly.
- Voucherly Components — il modulo di pagamento mostrato dentro la tua pagina.
- Integrazione personalizzata — il tuo selettore di gateway sopra le API REST, per il pieno controllo del flusso di pagamento.
La vendita di persona, da un chiosco o da un distributore automatico, è trattata in Pagamenti di persona.
5. Prima di andare in produzione
Per iniziare a elaborare transazioni reali, dobbiamo verificare e approvare le informazioni del tuo account merchant.
- Attiva il tuo account fornendo le informazioni sulla tua azienda.
- Assicurati che il tuo sito web sia conforme alla Checklist del sito web.
Una volta inviata la richiesta, effettueremo le verifiche KYC (know your customer). Se approvato, il tuo account verrà attivato in produzione.