TWINT per Medusa
TWINT è l’app di pagamento più utilizzata in Svizzera. In combinazione con Medusa, il framework ecommerce open source per shop headless, offri alla tua clientela esattamente il metodo di pagamento che si aspetta nel checkout. Con zahls.ch colleghi i due senza programmare: crea un account, configura l’integrazione, attiva TWINT. TWINT appare poi direttamente nel checkout del tuo shop Medusa e tutte le transazioni confluiscono in modo chiaro nella tua dashboard.
Medusa è un framework ecommerce open source per shop headless: prodotti, carrello, checkout e admin girano come backend Node.js collegato a storefront e app custom via API.
Il collegamento a zahls.ch avviene tramite il pacchetto npm ufficiale @zahls/medusa-plugin. Lo installi nel backend Medusa, registri il payment provider in medusa-config.ts e inserisci chiave API e nome istanza.
I clienti pagano tramite il checkout ospitato di zahls.ch (redirect). Capture, rimborsi e aggiornamenti di stato passano dai webhook di pagamento Medusa – con verifica HMAC opzionale.
Medusa è adatto a team che gestiscono uno shop headless orientato allo sviluppo e servono metodi di pagamento svizzeri come TWINT, carte e PostFinance.
Funzionalità
- Plugin npm ufficiale per Medusa v2
- Checkout ospitato con redirect
- Capture e rimborsi tramite API
- Webhook con verifica HMAC opzionale
- TWINT, carte e PostFinance nel checkout
Vantaggi
- Conversione elevata sul mercato svizzero
- Attivazione rapida senza competenze di programmazione
- Collegamento API stabile con aggiornamenti di stato automatici
- Integrazione ufficiale Medusa v2 con webhook
Casi d uso
TWINT per Medusa conviene in molti scenari:
- Clientela svizzera che paga da mobile e via codice QR con l’app TWINT
- Negozi che vogliono ridurre gli abbandoni nel checkout con metodi di pagamento familiari
- Commercianti che vogliono gestire transazioni, rimborsi e versamenti in un unico posto
Setup
Come configurare TWINT in Medusa
- Crea un account zahls.ch e completa la verifica.
- Installa il pacchetto npm @zahls/medusa-plugin, registra il payment provider in medusa-config.ts e inserisci chiave API e nome istanza.
- Inserisci le chiavi API dalla tua dashboard zahls.ch nelle impostazioni dell’integrazione.
- Attiva TWINT come metodo di pagamento e salva la configurazione.
- Esegui un pagamento di prova in modalità test e poi metti il negozio online.
FAQ
Serve un contratto separato per TWINT?
No. L’accettazione TWINT è inclusa nel tuo account zahls.ch, non serve un contratto di accettazione separato.
Quanto dura la configurazione in Medusa?
Di solito meno di un’ora: installare l’integrazione, inserire le chiavi API, attivare il metodo di pagamento e testare.
Quanto costa usare TWINT?
Le commissioni di transazione dipendono dal piano zahls.ch scelto. Per l’integrazione stessa non ci sono costi di attivazione.