Mikä on maksuyhdyskäytävä? Verkkomaksut selitettynä

Maksuyhdyskäytävä on palvelu, joka ottaa asiakkaan maksutiedot turvallisesti kassalla, välittää ne pankeille ja korttiverkostoille hyväksyttäväksi ja palauttaa vastauksen ”hyväksytty” tai ”hylätty”, yleensä muutamassa sekunnissa. Se on silta sovelluksesi ja rahoitusjärjestelmän välillä. Stripe, PayPal, Adyen, Square ja Braintree ovat tunnettuja esimerkkejä.

Nykyään useimmat näistä yhtiöistä yhdistävät yhdyskäytävän kaikkeen muuhun, mitä tarvitset rahan saamiseen, joten ”maksuyhdyskäytävä”, ”maksunkäsittelijä” ja ”maksupalveluntarjoaja” tarkoittavat usein samaa asiaa.

Miksi maksuyhdyskäytävät ovat tärkeitä, kun rakennat tekoälyllä

”Lisää maksut” on yksi yleisimmistä pyynnöistä tekoälyrakentajille, ja yksi helpoimmista tehdä hienovaraisesti väärin. Koodi itsessään on yleensä lyhyt. Tärkeät osat ovat sen ympärillä olevat päätökset:

• Mikä palveluntarjoaja sopii liiketoimintaasi, maahasi ja myymiisi tuotteisiin.
• Missä koodi ajetaan. Salaiset maksuavaimet pitää pitää palvelimella, ei koskaan selaimessa.
• Miten sovelluksesi oppii, että maksu onnistui. Luotettava tapa on webhook palveluntarjoajalta, ei asiakkaan laskeutuminen ”kiitos”-sivulle.
• Lakisääteiset ja verotukselliset vastuusi, jotka riippuvat siitä, kuka on merchant of record.

Maksuyhdyskäytävän toiminnan ymmärtäminen auttaa antamaan selkeitä ohjeita ja tarkistamaan, että tulos on turvallinen.

Arkinen vertauskuva

Ajattele korttimaksua kaupassa.

Kortinlukija kassalla on yhdyskäytävä: se lukee kortin turvallisesti ja lähettää pyynnön eteenpäin. Se ei päätä mitään. Se välittää kysymyksen ”voiko tämä henkilö maksaa 40 euroa?” ketjua pitkin pankillesi ja palauttaa vastauksen. Kaupan pankki (acquirer) ja sinun pankkisi (issuer) tekevät päätöksen korttiverkoston (Visa, Mastercard) kautta, joka yhdistää ne.

Verkkomaksuyhdyskäytävä on tuo kortinlukija, rakennettuna verkkoon, ja lisättynä turvallisuudella, jolla korttitietoja käsitellään internetin yli.

Miten verkkokorttimaksu toimii

Tässä tapahtuu muutamassa sekunnissa sen jälkeen, kun asiakas painaa ”Maksa”:

Kaksi kohtaa kannattaa tietää:

• Valtuutus ei ole sama asia kuin maksun saaminen. Raha varataan ensin, sitten veloitetaan ja lopulta selvitetään tilillesi, usein päivien päästä.
• Sovelluksesi ei näe korttinumeroa lainkaan. Nykyaikaiset palveluntarjoajat antavat isännöidyn kassasivun tai upotetut kentät, joita he hallitsevat, ja sovelluksesi saa vain viitteen maksuun.

Pääosat ja kuka hoitaa ne

Jotkut palveluntarjoajat (Paddle, Lemon Squeezy) toimivat itse merchant of recordina ja hoitavat myyntiveron ja ALV:n puolestasi korkeampaa palkkiota vastaan. Toiset (Stripe, PayPal) jättävät sinut merchant of recordiksi, ja tarjolla on valinnaisia verotyökaluja. Reilu vertailu vaihtoehdoista löytyy artikkeleista Stripe vs. Paddle vs. Lemon Squeezy ja Stripe vs. PayPal.

Esimerkki: kurssin myynti

Myyt verkkokurssin 99 eurolla ja pyydät tekoälyrakentajaa lisäämään ”Osta”-painikkeen.

1. Asiakas klikkaa Osta. Palvelimesi pyytää salaisella avaimellaan palveluntarjoajaa luomaan checkout-istunnon 99 eurolle ja saa takaisin linkin.
2. Asiakas ohjataan palveluntarjoajan isännöidylle kassasivulle, syöttää korttinsa ja suorittaa mahdollisen 3D Secure -tarkistuksen pankkinsa kanssa.
3. Maksu hyväksytään, ja asiakas ohjataan ”onnistui”-sivullesi.
4. Erikseen palveluntarjoaja lähettää palvelimellesi webhookin: ”maksu istunnolle X onnistui”. Palvelin tarkistaa webhookin allekirjoituksen, löytää tilauksen, merkitsee sen maksetuksi ja avaa kurssin.
5. Päivien päästä rahat, vähennettyinä palkkioilla, tulevat tilillesi.

Vaihe 4 on tärkein. Jos avaisit kurssin onnistumissivulla, kuka tahansa, joka löytäisi tuon URL-osoitteen, saisi kurssin ilmaiseksi, ja asiakkaat, joiden selain sulkeutui aikaisin, maksaisivat eivätkä saisi mitään.

Keskeiset termit

Yleisiä väärinkäsityksiä

• „Minun täytyy tallentaa korttinumerot, jotta voin veloittaa asiakkaita uudelleen.” Ei. Palveluntarjoajat tallentavat kortin ja antavat sinulle viitetunnuksen toistuvia veloituksia ja tilauksia varten. Sinun ei pidä koskaan tallentaa korttinumeroita itse.
• „Onnistumissivu tarkoittaa, että maksu onnistui.” Vahvista maksut webhookeilla palvelimella. Uudelleenohjaukset voidaan ohittaa, väärentää tai ne eivät tapahdu lainkaan.
• „Kaikki palveluntarjoajat maksavat suunnilleen saman.” Palkkiot vaihtelevat palveluntarjoajan, maan, korttityypin ja sen mukaan, onko verokäsittely mukana. Tarkista kunkin palveluntarjoajan nykyinen hinnoittelu maallesi.
• „Stripen käyttö tekee minusta PCI-yhteensopivan.” Se tekee yhteensopivuudesta paljon helpompaa, koska korttitiedot pysyvät palveluntarjoajalla, mutta sinulla on silti (yleensä lyhyt) itsearviointi tehtävänä.
• „Testitila ja live-tila toimivat täsmälleen samoin.” Ne ovat lähellä toisiaan, mutta live-tila vaatii täysin vahvistetun tilin, live-ympäristöön asetetut webhook-päätepisteet ja oikeat pankkitiedot.
• „Maksuyhdyskäytävä hoitaa verot puolestani.” Vain jos se on merchant of record tai jos otat sen verotyökalut käyttöön ja määrität ne. Tarkista paikalliset säännöt tai kysy neuvoa asiantuntijalta.

Mitä pyytää tekoälyrakentajalta

• „Lisää [Stripe] Checkout tuotteelle [tuote]. Luo istunto palvelimella käyttäen salaista avainta ympäristömuuttujasta.”
• „Merkitse tilauksia maksetuiksi vain vahvistetusta webhookista. Tarkista webhookin allekirjoitus.”
• „Käsittele se, että webhook lähetetään kahdesti, niin ettei synny kaksoistilauksia.”
• „Käytä testitilan avaimia ja opasta minut testaamaan palveluntarjoajan testikorteilla, myös hylätyllä kortilla.”
• „Mitä tapahtuu, jos asiakas sulkee välilehden maksun jälkeen?”
• „Näytä jokainen paikka, jossa maksuavainta käytetään, ja vahvista, ettei salainen avain koskaan päädy selaimeen.”

Maksuyhdyskäytävät Mythexissä

Mythexissa rakentamiisi sovelluksiin ei kuulu sisäänrakennettuja maksuja, eikä ”Yhdistä Stripe” -painiketta ole. Luot tilin valitsemallasi palveluntarjoajalla, lisäät sen testiavaimet projektin salaisuuksiksi ja pyydät agenttia rakentamaan kassan palvelinpuolelle. Testaa esikatselussa palveluntarjoajan testikorteilla ja julkaise sitten. Dokumentaatio käy tämän läpi kohdassa Hyväksy maksuja Stripellä, ja Webhookit kattaa vahvistusvaiheen.

Vaiheittaiseen rakentamiseen katso miten lisäät maksut sovellukseesi ja toistuvaan laskutukseen miten lisäät tilaukset Stripellä.

Kysymykset