Mastercard per Medusa
Mastercard è uno dei principali circuiti di carte al mondo. 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 Mastercard. Mastercard 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
- Ampia accettazione presso clientela locale e internazionale
- Attivazione rapida senza competenze di programmazione
- Collegamento API stabile con aggiornamenti di stato automatici
- Integrazione ufficiale Medusa v2 con webhook
Casi d uso
Mastercard per Medusa conviene in molti scenari:
- Clienti in Svizzera e all’estero che pagano con carta di credito o di debito
- 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 Mastercard 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 Mastercard 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 Mastercard?
No. L’accettazione delle carte passa dal tuo account zahls.ch, non ti serve un contratto di acquiring proprio.
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 Mastercard?
Le commissioni di transazione dipendono dal piano zahls.ch scelto. Per l’integrazione stessa non ci sono costi di attivazione.