Què és una passarel·la de pagament? Com funcionen els pagaments en línia

Una passarel·la de pagament és el servei que pren de manera segura les dades de pagament d'un client al checkout, les passa als bancs i a les xarxes de targetes per a l'aprovació, i retorna una resposta d'«aprovat» o «rebutjat» —normalment en pocs segons. És el pont entre la teva aplicació i el sistema financer. Stripe, PayPal, Adyen, Square i Braintree són exemples coneguts.

Avui en dia, la majoria d'aquestes empreses agrupen la passarel·la amb tot el que necessites per cobrar, així que «passarel·la de pagament», «processador de pagaments» i «proveïdor de pagaments» sovint s'usen per dir el mateix.

Per què les passarel·les de pagament importen quan construeixes amb IA

«Afegeix pagaments» és una de les peticions més habituals que la gent fa als constructors amb IA, i una de les més fàcils de fer malament de manera subtil. El codi en si sol ser curt. Les parts importants són les decisions que hi ha al voltant:

• Quin proveïdor. Quin encaixa amb el teu negoci, el teu país i el que vens.
• On s'executa el codi. Les claus secretes de pagament han de quedar al servidor, mai al navegador.
• Com sap la teva aplicació que un pagament ha reeixit. La manera fiable és un webhook del proveïdor —no que el client arribi a una pàgina d'«agraïment».
• Les teves responsabilitats legals i fiscals, que depenen de qui és el comerciant registrat.

Entendre què fa una passarel·la t'ajuda a donar instruccions clares i a comprovar que el resultat és segur.

Una analogia del dia a dia

Pensa en pagar amb targeta en una botiga.

El terminal de targetes del taulell és la passarel·la: llegeix la teva targeta de manera segura i envia la petició. No decideix res: passa la pregunta «aquesta persona pot pagar 40 €?» per una cadena fins al teu banc i en retorna la resposta. El banc de la botiga (adquirent) i el teu banc (emissor) són els que decideixen, a través de la xarxa de targetes (Visa, Mastercard) que els connecta.

Una passarel·la de pagament en línia és aquell terminal, refet per a la web, més la seguretat per gestionar les dades de targeta que arriben per internet.

Com funciona un pagament amb targeta en línia

Això és el que passa en els pocs segons després que un client premi «Pagar»:

Dos punts valen la pena:

• L'autorització no és el mateix que cobrar. Primer es reserven els diners, després es capturen i finalment es liquiden al teu compte, sovint dies més tard.
• La teva aplicació no hauria de veure mai el número de targeta. Els proveïdors moderns et donen una pàgina de checkout allotjada o uns camps integrats que ells controlen, i la teva aplicació només rep una referència al pagament.

Les peces principals i qui se n'encarrega

Alguns proveïdors (Paddle, Lemon Squeezy) actuen ells mateixos com a comerciant registrat, i gestionen l'IVA i els impostos de vendes per a tu a canvi de comissions més altes. Altres (Stripe, PayPal) et deixen com a comerciant registrat, amb eines fiscals opcionals. Per a una comparació justa de les opcions, consulta Stripe vs Paddle vs Lemon Squeezy i Stripe vs PayPal.

Un exemple pràctic: vendre un curs

Vens un curs en línia per 99 € i demanes al teu constructor amb IA que afegeixi un botó «Comprar».

1. El client fa clic a Comprar. El teu servidor, amb la seva clau secreta, demana al proveïdor que creï una sessió de checkout per 99 € i rep un enllaç.
2. El client és enviat a la pàgina de checkout allotjada del proveïdor, introdueix la targeta i completa qualsevol comprovació 3D Secure amb el seu banc.
3. El pagament és aprovat i el client és redirigit a la teva pàgina d'«èxit».
4. Per separat, el proveïdor envia un webhook al teu servidor: «el pagament de la sessió X s'ha completat». El teu servidor comprova la signatura del webhook, troba la comanda, la marca com a pagada i desbloqueja el curs.
5. Dies més tard, els diners menys les comissions arriben al teu compte bancari.

El pas 4 és el més important. Si desbloquegessis el curs a la pàgina d'èxit, qualsevol que trobés aquell URL el podria obtenir gratis, i els clients que tanquessin el navegador abans de temps pagarien i no rebrien res.

Termes clau

Idees equivocades habituals

• «He d'emmagatzemar els números de targeta per tornar a cobrar els clients.» No. Els proveïdors guarden la targeta i et donen un token de referència per als cobraments repetits i les subscripcions. Mai no hauries d'emmagatzemar números de targeta tu mateix.
• «La pàgina d'èxit vol dir que el pagament ha funcionat.» Confirma els pagaments amb webhooks al servidor. Les redireccions es poden saltar, falsificar o no passar mai.
• «Tots els proveïdors de pagament costen més o menys el mateix.» Les comissions varien segons el proveïdor, el país, el tipus de targeta i si inclouen la gestió d'impostos. Revisa la pàgina de preus actual de cada proveïdor per al teu país.
• «Usar Stripe em fa complir amb PCI.» Ho simplifica molt, perquè les dades de la targeta es queden amb el proveïdor, però encara has de completar una autoavaluació (normalment curta).
• «El mode de prova i el mode real es comporten exactament igual.» S'hi assemblen, però el mode real necessita un compte totalment verificat, punts de connexió de webhook configurats per a l'entorn real i dades bancàries reals.
• «Una passarel·la de pagament gestiona els meus impostos.» Només si és el comerciant registrat o si tu actives i configures les seves eines fiscals. Revisa les normes locals o demana-ho a un assessor.

Què demanar al teu constructor amb IA

• «Afegeix el checkout de [Stripe] per a [producte]. Crea la sessió al servidor fent servir la clau secreta d'una variable d'entorn.»
• «Marca les comandes com a pagades només des d'un webhook verificat, i comprova la signatura del webhook.»
• «Gestiona el cas que el webhook s'enviï dues vegades sense crear comandes duplicades.»
• «Usa les claus del mode de prova i explica'm com provar amb les targetes de prova del proveïdor, incloent-hi una targeta rebutjada.»
• «Què passa si el client tanca la pestanya després de pagar?»
• «Mostra'm tots els llocs on s'usa una clau de pagament, i confirma que la clau secreta mai no arriba al navegador.»

Passarel·les de pagament a Mythex

Mythex no inclou pagaments integrats per a les aplicacions que construeixes, i no hi ha cap botó d'un clic «Connecta Stripe». Crees un compte amb el proveïdor que triïs, afegeixes les seves claus de prova com a secrets del projecte i demanes a l'agent que construeixi el checkout al costat del servidor. Prova-ho a la previsualització amb les targetes de prova del proveïdor i després publica. La documentació ho explica pas a pas a Accepta pagaments amb Stripe, i Webhooks cobreix el pas de confirmació.

Per a una construcció pas a pas, consulta com afegir pagaments a la teva aplicació i, per a la facturació recurrent, com afegir subscripcions amb Stripe.

Preguntes