Šta je payment gateway? Kako rade online plaćanja, objašnjeno

Payment gateway je servis koji sigurno preuzima podatke o plaćanju kupca na blagajni, prosljeđuje ih bankama i karticama na odobrenje i vraća odgovor „odobreno” ili „odbijeno” — obično u roku od nekoliko sekundi. On je most između vaše aplikacije i finansijskog sistema. Stripe, PayPal, Adyen, Square i Braintree su poznati primjeri.

Danas većina ovih kompanija objedinjuje gateway sa svime ostalim što vam treba da naplatite, pa se „payment gateway”, „payment procesor” i „provajder plaćanja” često koriste kao isto.

Zašto su payment gateway-i važni kada gradite uz AI

„Dodaj plaćanja” je jedan od najčešćih zahtjeva koje ljudi postavljaju AI alatima, i jedan od najlakših za suptilno pogrešno urađenje. Sam kod je obično kratak. Važni su dijelovi oko njega:

• Koji provajder odgovara vašem poslu, državi i onome što prodajete.
• Gdje kod radi. Tajni ključevi za plaćanja moraju ostati na serveru, nikada u pregledniku.
• Kako vaša aplikacija saznaje da je plaćanje uspjelo. Pouzdan način je webhook od provajdera — a ne to što kupac stigne na stranicu „hvala”.
• Vaše pravne i porezne obaveze, koje zavise od toga ko je merchant of record.

Razumijevanje šta gateway radi pomaže vam da date jasna uputstva i provjerite da je rezultat bezbjedan.

Svakodnevna analogija

Zamislite plaćanje karticom u radnji.

POS terminal na pultu je gateway: sigurno čita vašu karticu i šalje zahtjev. On ništa ne odlučuje — prosljeđuje pitanje „može li ova osoba platiti 40 €?” duž lanca do vaše banke i dobija odgovor nazad. Banka trgovca (akvizitor) i vaša banka (izdavalac) donose odluku, preko kartičarske mreže (Visa, Mastercard) koja ih povezuje.

Online payment gateway je taj terminal prilagođen webu — uz dodatu sigurnost za rukovanje podacima o karticama koji stižu preko interneta.

Kako funkcioniše online plaćanje karticom

Evo šta se dešava u nekoliko sekundi nakon što kupac klikne „Plati”:

Dvije stvari vrijedi znati:

• Autorizacija nije isto što i naplata. Novac se prvo rezerviše, zatim naplaćuje, a zatim poravna na vaš račun — često nakon nekoliko dana.
• Vaša aplikacija uopšte ne bi smjela vidjeti broj kartice. Moderni provajderi daju hostovanu stranicu za plaćanje ili ugrađena polja pod svojom kontrolom, a vaša aplikacija dobija samo referencu na plaćanje.

Glavni dijelovi i ko ih obrađuje

Neki provajderi (Paddle, Lemon Squeezy) sami djeluju kao merchant of record, pa obračunavaju i plaćaju porez na promet i PDV umjesto vas, uz veće naknade. Drugi (Stripe, PayPal) ostavljaju vas kao merchant of record, uz opcione porezne alate. Za pošten pregled opcija pogledajte Stripe naspram Paddle-a naspram Lemon Squeezy-ja i Stripe naspram PayPal-a.

Praktičan primjer: prodaja kursa

Prodajete online kurs za 99 € i tražite od AI alata da doda dugme „Kupi”.

1. Kupac klikne Kupi. Vaš server koristi svoj tajni ključ da zatraži od provajdera kreiranje sesije plaćanja za 99 € i dobija nazad link.
2. Kupac se preusmjeri na provajderovu hostovanu stranicu za plaćanje, unese karticu i završi eventualnu 3D Secure provjeru sa svojom bankom.
3. Plaćanje je odobreno i kupac se preusmjeri na vašu stranicu „uspjeh”.
4. Zasebno, provajder šalje webhook vašem serveru: „plaćanje za sesiju X je uspjelo.” Vaš server provjerava potpis webhook-a, pronalazi narudžbu, označava je kao plaćenu i otključava kurs.
5. Nekoliko dana kasnije novac umanjen za naknade stiže na vaš bankovni račun.

Korak 4 je najvažniji. Da ste kurs otključali na stranici uspjeha, svako ko nađe tu adresu mogao bi ga dobiti besplatno, a kupci čiji se preglednik zatvorio prerano platili bi i ništa ne bi dobili.

Ključni pojmovi

Česta pogrešna shvatanja

• „Moram čuvati brojeve kartica da bih ponovo naplatio kupce.” Ne. Provajderi čuvaju karticu i daju vam referentni token za ponovna plaćanja i pretplate. Brojeve kartica nikada ne biste trebali čuvati sami.
• „Stranica uspjeha znači da je plaćanje uspjelo.” Potvrdite plaćanja webhook-ovima na serveru. Preusmjeravanja se mogu preskočiti, lažirati ili se nikada ne dogode.
• „Svi provajderi koštaju otprilike isto.” Naknade variraju po provajderu, državi, vrsti kartice i tome da li je uključen obračun poreza. Provjerite aktuelnu stranicu cijena provajdera za vašu državu.
• „Korištenje Stripe-a me čini PCI usklađenim.” To znatno pojednostavljuje usklađenost, jer podaci o kartici ostaju kod provajdera — ali i dalje morate popuniti samoprocjenu, obično kratku.
• „Testni i živi režim se ponašaju identično.” Blizu su, ali živi režim traži potpuno verifikovan račun, prave webhook adrese postavljene za živo okruženje i prave bankovne podatke.
• „Payment gateway rješava moje poreze.” Samo ako je on merchant of record ili ako uključite i podesite njegove porezne alate. Provjerite lokalna pravila ili se posavjetujte sa savjetnikom.

Šta tražiti od AI graditelja

• „Dodaj [Stripe] Checkout za [proizvod]. Kreiraj sesiju na serveru koristeći tajni ključ iz varijable okruženja.”
• „Označi narudžbe kao plaćene samo iz provjerenog webhook-a i provjeri potpis webhook-a.”
• „Obradi slučaj da webhook stigne dva puta, bez kreiranja dupliranih narudžbi.”
• „Koristi ključeve iz testnog režima i prođi sa mnom testiranje pomoću testnih kartica provajdera, uključujući odbijenu karticu.”
• „Šta se dešava ako kupac zatvori karticu nakon plaćanja?”
• „Pokaži mi svako mjesto gdje se koristi ključ za plaćanja i potvrdi da tajni ključ nikada ne dolazi do preglednika.”

Payment gateway-i na Mythex-u

Mythex ne uključuje ugrađena plaćanja za aplikacije koje pravite, i nema jednoklikovskog „Poveži Stripe”. Vi otvarate račun kod izabranog provajdera, dodajete njegove testne ključeve kao tajne projekta i zamolite agenta da napravi blagajnu na serverskoj strani. Testirajte u pregledu uz testne kartice provajdera, pa objavite. Dokumentacija to prolazi u Prihvatanje plaćanja sa Stripe-om, a Webhook-ovi pokrivaju korak potvrde.

Za izradu korak po korak pogledajte kako dodati plaćanja u aplikaciju i, za ponavljajuću naplatu, kako dodati pretplate sa Stripe-om.

Pitanja