Mis on makseväravi? Kuidas veebimaksed toimivad, selgitatult

Makseväravi on teenus, mis võtab turvaliselt kliendi makseandmed kassas vastu, edastab need pankadele ja kaardivõrkudele kinnitamiseks ning saadab tagasi „kinnitatud“ või „tagasi lükatud“ — tavaliselt paari sekundi jooksul. See on sinu rakenduse ja finantssüsteemi vaheline sild. Stripe, PayPal, Adyen, Square ja Braintree on tuntud näited.

Tänapäeval pakub enamik neist ettevõtetest makseväravi koos kõigega, mida vajad raha saamiseks, seega terminit „makseväravi“, „makseprotsessor“ ja „maksepakkuja“ kasutatakse sageli samas tähenduses.

Miks makseväravid AI-ga ehitamisel tähtsad on

„Lisa maksed“ on üks sagedasemaid päringuid AI-ehitajatele ja üks kergemini peenelt valesti minevaid. Kood ise on tavaliselt lühike. Olulised on otsused selle ümber:

• Milline teenusepakkuja sobib sinu ettevõttele, riigile ja sellele, mida müüd.
• Kus kood töötab. Salajased maksevõtmed peavad jääma serverisse, mitte kunagi brauserisse.
• Kuidas su rakendus saab teada, et makse õnnestus. Usaldusväärne viis on teenusepakkuja veebihaak — mitte see, et klient jõuab „aitäh“-lehele.
• Sinu õiguslikud ja maksukohustused, mis sõltuvad sellest, kes on kaupmees-müüja.

Makseväravi tegevuse mõistmine aitab anda selgeid juhiseid ja kontrollida, et tulemus on turvaline.

Igapäevane võrdlus

Mõtle kaardiga maksmisele poes.

Kaarditerminal letil on makseväravi: see loeb sinu kaarti turvaliselt ja saadab päringu edasi. See ei otsusta midagi — see edastab küsimuse „kas see inimene saab maksta 40 eurot?“ ahelas sinu pangani ja toob vastuse tagasi. Poe pank (acquirer) ja sinu pank (issuer) teevad otsuse, läbi kaardivõrgu (Visa, Mastercard), mis neid ühendab.

Veebi makseväravi on see terminal, mis on veebi jaoks ümber ehitatud — koos turvalisusega, mis käsitleb internetis saabuvaid kaardiandmeid.

Kuidas veebi kaardimakse toimib

Siin on, mis juhtub mõne sekundi jooksul pärast seda, kui klient klõpsab „Maksa“:

Mõned punktid on kasulik teada:

• Autoriseerimine ei ole sama mis raha saamine. Raha reserveeritakse esmalt, seejärel kogutakse ja alles siis arveldatakse sinu kontole — sageli mitme päeva pärast.
• Sinu rakendus ei peaks kaardinumbrit üldse nägema. Kaasaegsed teenusepakkujad annavad sulle hostitud kassaleheküljed või sisseehitatud väljad, mida nad ise kontrollivad, ja sinu rakendus saab ainult makse viite.

Peamised osad ja kes neid käsitleb

Mõned teenusepakkujad (Paddle, Lemon Squeezy) tegutsevad ise kaupmees-müüjana ja käsitlevad sinu eest käibemaksu ja VAT-i kõrgemate tasude eest. Teised (Stripe, PayPal) jätavad sind kaupmees-müüjaks valikuliste maksutööriistadega. Erapooletu ülevaate saamiseks vaata Stripe vs Paddle vs Lemon Squeezy ja Stripe vs PayPal.

Töötav näide: kursuse müümine

Müüd veebikursust 99 euro eest ja palud AI-ehitajal lisada nupu „Osta“.

1. Klient klõpsab Osta. Sinu server kasutab oma salajast võtit, et paluda teenusepakkujal luua 99 euro suurune makseseanss ja saab vastu lingi.
2. Klient suunatakse teenusepakkuja hostitud maksekassa lehele, sisestab oma kaardi ja teeb vajaduse korral 3D Secure kontrolli oma pangaga.
3. Makse kinnitatakse ja klient suunatakse sinu lehele „õnnestus“.
4. Eraldi saadab teenusepakkuja sinu serverisse veebihaagi: „seansi X makse õnnestus“. Sinu server kontrollib veebihaagi allkirja, leiab tellimuse, märgib selle makstuks ja avab kursuse.
5. Mõne päeva pärast jõuab raha, millest on tasud maha arvatud, sinu pangakontole.

Samm 4 on kõige olulisem. Kui avaksid kursuse hoopis õnnestumislehel, saaks iga, kes selle URL-i leidis, kursuse tasuta, ja kliendid, kelle brauser sulgus enne lõppu, maksaksid ega saaks midagi.

Põhimõisted

Levinud väärarusaamad

• „Pean kaardinumbrid salvestama, et kliente uuesti laadida.“ Ei pea. Teenusepakkujad salvestavad kaardi ja annavad sulle viidemärgi korduvateks maksmisteks ja tellimusteks. Kaardinumbreid ei tohiks kunagi ise salvestada.
• „Õnnestumislehe kuvamine tähendab, et makse õnnestus.“ Kinnita makseid serveris veebihaakide kaudu. Suunamised võivad vahele jääda, olla võltsitud või hoopis mitte juhtuda.
• „Kõik maksepakkujad maksavad umbes sama palju.“ Tasud erinevad teenusepakkuja, riigi, kaardi tüübi ja selle järgi, kas maksukäsitlus on kaasatud. Vaata iga teenusepakkuja praegust hinnalehte oma riigi kohta.
• „Stripe’i kasutamine muudab mind PCI-vastavaks.“ See teeb vastavuse palju lihtsamaks, sest kaardiandmed jäävad teenusepakkujale — aga sul on ikka täita (tavaliselt lühike) enesehindamine.
• „Testrežiim ja tootmisrežiim käituvad täpselt ühtemoodi.“ Need on lähedased, kuid tootmisrežiim nõuab täielikult kinnitatud kontot, tootmiskeskkonna jaoks seadistatud päris veebihaakide lõpp-punkte ja päris pangaandmeid.
• „Makseväravi tegeleb minu maksudega.“ Ainult siis, kui see on kaupmees-müüja või sa lülitad sisse ja seadistad selle maksufunktsioonid. Kontrolli oma kohalikke reegleid või küsi nõu.

Mida küsida oma AI-ehitajalt

• „Lisa [Stripe’i] makseseanss [tootele]. Loo seanss serveris, kasutades salajast võtit keskkonnamuutujast.“
• „Märgi tellimusi makstuks ainult kinnitatud veebihaagist ja kontrolli veebihaagi allkirja.“
• „Käsitle olukorda, kus veebihaak saadetakse kaks korda, ilma et tekiksid topeltellimused.“
• „Kasuta testrežiimi võtmeid ja juhenda mind testimisel teenusepakkuja testkaartidega, sealhulgas tagasilükatud kaardiga.“
• „Mis juhtub, kui klient sulgeb vahelehe pärast maksmist?“
• „Näita mulle iga kohta, kus makse võtit kasutatakse, ja kinnita, et salajane võti ei jõua kunagi brauserisse.“

Makseväravid Mythexis

Mythex ei sisalda sinu ehitatud rakenduste jaoks sisseehitatud makseid ning ühe klõpsuga „Ühenda Stripe“ ei ole. Loo konto valitud teenusepakkujas, lisa selle testvõtmed projekti saladustena ja palu agendil ehitada maksekassa serveripoolne osa. Testi eelvaates teenusepakkuja testkaartidega ja avalda seejärel. Dokumentatsioon käib selle läbi lehel Maksete vastuvõtmine Stripe’iga ja Veebihaagid käsitleb kinnitamise sammu.

Sammhaaval ehitamiseks vaata kuidas lisada makseid oma rakendusse ja korduvate arvete jaoks kuidas lisada tellimusi Stripe’iga.

Küsimused