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

Payment gateway je servis koji bezbedno preuzima podatke o plaćanju kupca na kasi, prosleđuje ih bankama i karticama na odobrenje i vraća „odobreno“ ili „odbijeno“ — obično za nekoliko sekundi. On je most između vaše aplikacije i finansijskog sistema. Stripe, PayPal, Adyen, Square i Braintree su poznati primeri.

Danas većina tih kompanija objedinjuje gateway sa svim ostalim što su vam potrebno da naplatite, pa se „payment gateway“, „payment processor“ i „payment provider“ često koriste kao da znače isto.

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

„Dodaj plaćanja“ jedan je od najčešćih zahteva koje ljudi upućuju AI graditeljima, i jedan od onih koji se lako pogreše na suptilan način. Sam kod je obično kratak. Važni su delovi oko njega:

• Koji provajder odgovara vašem poslu, zemlji i onome što prodajete.
• Gde se kod izvršava. Tajni ključevi za plaćanje moraju ostati na serveru, nikada u pregledaču.
• Kako vaša aplikacija saznaje da je plaćanje uspelo. Pouzdan način je webhook od provajdera — a ne da kupac stigne na stranicu „hvala“.
• Vaše pravne i porezne obaveze, koje zavise od toga ko je merchant of record.

Razumevanje onoga što gateway radi pomaže vam da date jasna uputstva i proverite da je rezultat bezbedan.

Svakodnevna analogija

Zamislite plaćanje karticom u radnji.

Karticni terminal na pultu je gateway: bezbedno čita vašu karticu i šalje zahtev dalje. On ništa ne odlučuje — prosleđuje pitanje „može li ova osoba da plati 40 €?“ duž lanca do vaše banke i vraća odgovor. Banka prodavca (akvizitor) i vaša banka (izdavalac) odlučuju, preko kartičke mreže (Visa, Mastercard) koja ih povezuje.

Onlajn payment gateway je taj terminal, prenet na veb — plus bezbednost za rukovanje podacima o karticama koji stižu preko interneta.

Kako radi onlajn plaćanje karticom

Evo šta se dešava u nekoliko sekundi posle nego što kupac klikne „Plati“:

Dve tačke vredi znati:

• Autorizacija nije isto što i plaćanje. Novac se prvo rezerviše, zatim naplaćuje, pa poravnava na vaš račun — često nekoliko dana kasnije.
• Vaša aplikacija uopšte ne bi smela da vidi broj kartice. Moderni provajderi daju vam hostovanu stranicu za naplatu ili ugrađena polja koja oni kontrolišu, a vaša aplikacija dobija samo referencu na plaćanje.

Glavni delovi i ko ih obrađuje

Neki provajderi (Paddle, Lemon Squeezy) sami deluju kao merchant of record, pa za vas obračunavaju porez na promet i PDV, u zamenu za viš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.

Primer: prodaja kursa

Prodajete onlajn kurs za 99 € i tražite od AI graditelja da doda dugme „Kupi“.

1. Kupac klikne Kupi. Vaš server koristi svoj tajni ključ da zatraži od provajdera da napravi sesiju za plaćanje za 99 € i dobije link nazad.
2. Kupac se šalje na provajderovu hostovanu stranicu za plaćanje, unosi karticu i završava eventualnu proveru 3D Secure sa svojom bankom.
3. Plaćanje je odobreno i kupac se preusmerava na vašu stranicu „uspeh“.
4. Zasebno, provajder šalje webhook vašem serveru: „plaćanje za sesiju X je uspelo.“ Vaš server proverava potpis webhook-a, pronalazi porudžbinu, 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 „uspeh“, svako ko pronađe taj URL mogao bi da ga dobije besplatno, a kupci čiji se pregledač zatvorio pre kraja platili bi i ne bi dobili ništa.

Ključni pojmovi

Česte zablude

• „Moram da čuvam brojeve kartica da bih ponovo naplatio kupce.“ Ne. Provajderi čuvaju karticu i daju vam referentni token za ponovne naplate i pretplate. Brojeve kartica nikada ne bi trebalo da čuvate sami.
• „Stranica uspeha znači da je plaćanje uspelo.“ Potvrdite plaćanja webhook-ovima na serveru. Preusmeravanja mogu biti preskočena, lažirana ili se nikada ne dogode.
• „Svi provajderi koštaju otprilike isto.“ Naknade se razlikuju po provajderu, zemlji, vrsti kartice i tome da li je uključena obrada poreza. Proverite trenutnu stranicu cena provajdera za svoju zemlju.
• „Korišćenje Stripe-a me čini PCI usklađenim.“ To znatno pojednostavljuje usklađenost, jer podaci o karticama ostaju kod provajdera — ali i dalje imate (obično kratak) samoprocenjivački upitnik.
• „Test i live režim se ponašaju potpuno isto.“ Vrlo su slični, ali live režim traži potpuno verifikovan nalog, stvarne webhook krajnje tačke za live okruženje i stvarne bankovne podatke.
• „Payment gateway obrađuje moje poreze.“ Samo ako je on merchant of record ili ako uključite i podesite njegove porezne funkcije. Proverite lokalna pravila ili pitajte savetnika.

Šta tražiti od AI graditelja

• „Dodaj [Stripe] Checkout za [proizvod]. Pravi sesiju na serveru koristeći tajni ključ iz promenljive okruženja.“
• „Označi porudžbine kao plaćene samo iz verifikovanog webhook-a i proveri potpis webhook-a.“
• „Obradi slučaj da se webhook pošalje dva puta, bez pravljenja duplih porudžbina.“
• „Koristi ključeve test režima i objasni mi testiranje test karticama provajdera, uključujući odbijenu karticu.“
• „Šta se dešava ako kupac zatvori karticu posle plaćanja?“
• „Pokaži mi svako mesto gde se koristi ključ za plaćanje i potvrdi da tajni ključ nikada ne stiže do pregledača.“

Payment gateway-i na Mythex-u

Mythex ne uključuje ugrađena plaćanja za aplikacije koje pravite, i nema dugmeta „Poveži Stripe“ u jednom koraku. Otvarate nalog kod izabranog provajdera, dodajete njegove test ključeve kao tajne projekta i tražite od agenta da napravi naplatu na serverskoj strani. Testirate u Pregledu test karticama provajdera, pa objavljujete. Dokumentacija to prolazi u prihvatanje plaćanja preko Stripe-a, a Webhook-ovi pokrivaju korak potvrde.

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

Pitanja