Cos'è un payment gateway? Come funzionano i pagamenti online, spiegato

Un payment gateway è il servizio che prende in modo sicuro i dati di pagamento del cliente al checkout, li passa alle banche e ai circuiti delle carte per l'approvazione e restituisce "approvato" o "rifiutato" — di solito in pochi secondi. È il ponte tra la tua app e il sistema finanziario. Stripe, PayPal, Adyen, Square e Braintree sono esempi noti.

Oggi la maggior parte di queste aziende unisce il gateway a tutto il resto di cui hai bisogno per incassare, quindi "payment gateway", "payment processor" e "fornitore di pagamenti" sono spesso usati per dire la stessa cosa.

Perché i payment gateway contano quando crei con l'AI

"Aggiungi i pagamenti" è una delle richieste più comuni che le persone fanno ai creatori con l'AI, ed è una delle più facili da sbagliare in modo sottile. Il codice in sé è di solito breve. Le parti importanti sono le decisioni che lo circondano:

• Quale fornitore si adatta alla tua attività, al tuo paese e a ciò che vendi.
• Dove gira il codice. Le chiavi segrete di pagamento devono restare sul server, mai nel browser.
• Come la tua app sa che un pagamento è andato a buon fine. Il modo affidabile è un webhook dal fornitore — non il cliente che arriva su una pagina di "grazie".
• Le tue responsabilità legali e fiscali, che dipendono da chi è il merchant of record.

Capire cosa fa un gateway ti aiuta a dare istruzioni chiare e a verificare che il risultato sia sicuro.

Un'analogia di tutti i giorni

Pensa a pagare con la carta in un negozio.

Il POS sul bancone è il gateway: legge la carta in modo sicuro e invia la richiesta. Non decide nulla — passa la domanda "questa persona può pagare 40 euro?" lungo una catena fino alla tua banca e riceve la risposta. La banca del negozio (acquirer) e la tua banca (issuer) fanno le valutazioni, tramite il circuito di carte (Visa, Mastercard) che le collega.

Un gateway di pagamento online è quel terminale, ricostruito per il web — più la sicurezza per gestire i dati delle carte che arrivano via internet.

Come funziona un pagamento online con carta

Ecco cosa succede nei pochi secondi dopo che il cliente clicca "Paga":

Due punti sono utili da sapere:

• L'autorizzazione non equivale a essere pagato. Prima il denaro viene riservato, poi catturato, poi regolato sul tuo conto — spesso dopo alcuni giorni.
• La tua app non dovrebbe mai vedere il numero della carta. I fornitori moderni offrono una pagina di checkout ospitata o campi incorporati che controllano loro, e la tua app riceve solo un riferimento al pagamento.

I componenti principali e chi li gestisce

Alcuni fornitori (Paddle, Lemon Squeezy) agiscono da merchant of record in prima persona, gestendo per te IVA e tasse sulle vendite in cambio di commissioni più alte. Altri (Stripe, PayPal) lasciano te come merchant of record, con strumenti fiscali opzionali. Per un confronto equilibrato delle opzioni, vedi Stripe vs Paddle vs Lemon Squeezy e Stripe vs PayPal.

Un esempio pratico: vendere un corso

Vendi un corso online a 99 euro e chiedi al tuo creatore con l'AI di aggiungere un pulsante "Acquista".

1. Il cliente clicca Acquista. Il tuo server usa la sua chiave segreta per chiedere al fornitore di creare una sessione di checkout da 99 euro e riceve un link.
2. Il cliente viene mandato alla pagina di checkout ospitata del fornitore, inserisce la carta e completa l'eventuale verifica 3D Secure con la sua banca.
3. Il pagamento viene approvato e il cliente viene reindirizzato alla tua pagina di "successo".
4. Separatamente, il fornitore invia un webhook al tuo server: "pagamento per la sessione X riuscito". Il tuo server verifica la firma del webhook, trova l'ordine, lo segna come pagato e sblocca il corso.
5. Giorni dopo, il denaro al netto delle commissioni arriva sul tuo conto bancario.

Il passaggio 4 è il più importante. Se sbloccassi il corso sulla pagina di successo, chiunque trovasse quell'URL lo otterrebbe gratis, e i clienti la cui finestra si chiude prima pagherebbero senza ricevere nulla.

Termini chiave

Idee sbagliate comuni

• "Devo memorizzare i numeri delle carte per addebitare di nuovo i clienti." No. I fornitori conservano la carta e ti danno un token di riferimento per addebiti ripetuti e abbonamenti. Non dovresti mai memorizzare tu i numeri delle carte.
• "La pagina di successo significa che il pagamento è andato a buon fine." Conferma i pagamenti con i webhook sul server. I reindirizzamenti possono essere saltati, falsificati o non avvenire mai.
• "Tutti i fornitori di pagamenti costano più o meno lo stesso." Le commissioni variano in base al fornitore, al paese, al tipo di carta e al fatto che sia incluso il trattamento fiscale. Controlla la pagina dei prezzi aggiornata del fornitore per il tuo paese.
• "Usare Stripe mi rende conforme alla PCI." Lo rende molto più semplice, perché i dati delle carte restano presso il fornitore — ma devi comunque completare un'autovalutazione, di solito breve.
• "La modalità di test e quella live si comportano in modo identico." Sono simili, ma la modalità live richiede un account completamente verificato, endpoint webhook configurati per l'ambiente live e coordinate bancarie reali.
• "Un payment gateway gestisce le mie tasse." Solo se è il merchant of record o se attivi e configuri le sue funzioni fiscali. Controlla le regole locali o chiedi a un consulente.

Cosa chiedere al tuo creatore con l'AI

• "Aggiungi [Stripe] Checkout per [prodotto]. Crea la sessione sul server usando la chiave segreta da una variabile d'ambiente."
• "Segna gli ordini come pagati solo da un webhook verificato, e controlla la firma del webhook."
• "Gestisci il caso in cui il webhook arrivi due volte senza creare ordini duplicati."
• "Usa le chiavi della modalità di test e spiegami come provare con le carte di test del fornitore, incluso una carta rifiutata."
• "Cosa succede se il cliente chiude la scheda dopo aver pagato?"
• "Mostrami ogni punto in cui viene usata una chiave di pagamento, e conferma che la chiave segreta non arriva mai al browser."

I payment gateway su Mythex

Mythex non include pagamenti integrati per le app che crei, e non esiste un pulsante "Collega Stripe" con un clic. Crei un account con il fornitore che scegli, aggiungi le sue chiavi di test come segreti del progetto e chiedi all'agente di costruire il checkout lato server. Prova in Anteprima con le carte di test del fornitore, poi pubblica. La documentazione spiega il procedimento in Accettare pagamenti con Stripe, e Webhook illustra il passaggio di conferma.

Per una costruzione passo dopo passo, vedi come aggiungere i pagamenti alla tua app e, per la fatturazione ricorrente, come aggiungere gli abbonamenti con Stripe.

Domande