Per iniziare
Le istruzioni seguenti ti guideranno nell'integrazione della tua piattaforma con le nostre API.
Configurazione
1. Crea un account Sandbox
Visita la Dashboard e registra un nuovo account.
Verifica il tuo indirizzo email cliccando sul link inviato alla tua casella di posta.
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 è destinata alle chiamate API dal frontend e consente esclusivamente la creazione dei pagamenti.
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
Definisci qual è l'integrazione più adatta a te e il tuo caso d'uso.
Plugin e-commerce
I plugin e-commerce di Voucherly, sviluppati internamente, richiedono uno sforzo di sviluppo minimo o nullo e ti permettono di iniziare a testare da subito. Offriamo un'ampia gamma di plugin e app per integrarti con piattaforme come PrestaShop, WooCommerce e Shopify.
Guida completa: Plugin e-commerce.
Integrazione API
Integra direttamente con le nostre API REST per il pieno controllo del flusso di pagamento. Ideale quando ti serve una logica personalizzata o la tua piattaforma non è coperta dai nostri plugin.
Guida completa: Integrazione API.
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.