Bancontact per Medusa
Bancontact è il metodo di pagamento più usato in Belgio. 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 Bancontact. Bancontact 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
- Un metodo di pagamento atteso per il mercato belga
- Attivazione rapida senza competenze di programmazione
- Collegamento API stabile con aggiornamenti di stato automatici
- Integrazione ufficiale Medusa v2 con webhook
Casi d uso
Bancontact per Medusa conviene in molti scenari:
- Clientela belga abituata a Bancontact
- 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 Bancontact 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 Bancontact 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 Bancontact?
No. Attivi Bancontact nel tuo account zahls.ch – senza un contratto di acquiring 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 Bancontact?
Le commissioni di transazione dipendono dal piano zahls.ch scelto. Per l’integrazione stessa non ci sono costi di attivazione.