Skip to main content
Tilauksen maksuvälilehti

Tilaukset > [Tilaus] > Maksu

​
Määritelmä

TWICE jakaa rahaliikenteen nelitasoiseen hierarkiaan: tilaus → kassa → maksu → tapahtuma. Tilaus kertoo, mitä ostetaan tai vuokrataan. Kassa kerää maksuaikeen. Maksu tuottaa alv-kuitin. Tapahtuma on varsinainen rahaliikenne maksupalveluntarjoajalla. Maksujen rinnalla ovat laskut — suoritusasiakirjat, jotka laskuttavat liikkuvan rahan. Hyvitykset, pantit, osamaksut ja jaetut maksutavat asettuvat kaikki siististi tähän hierarkiaan.

​
Missä tätä käytetään?

  • Maksupalveluntarjoajien määritys kohdassa Asetukset → Maksut
  • Asiakkaiden veloittaminen kassalla (verkossa tai hallintapaneelissa)
  • Panttien käsittely vuokratilauksissa
  • Täysien tai osittaisten hyvitysten tekeminen veloitetuista tapahtumista
  • Raporttien täsmäytys maksupalveluntarjoajan tilityksiin
  • API-integraatiot, joiden on kirjattava manuaalisia maksuja tai tehtävä hyvityksiä

​
Keskeiset ominaisuudet

​
Maksujen hierarkia

Tilaus sisältää kaikki rivitiedot (sen mitä asiakas ostaa tai vuokraa). Jokainen maksuprosessi alkaa tilauksesta.Lue lisää: Tilauksen elinkaari
kuvaavat sitä, mitä asiakas ostaa tai vuokraa. Jokainen rivitieto viittaa seuraaviin:
  • Listaus (tai kertaluonteinen rivitieto)
  • Määrä
  • Hintatiedot
  • Liittyvät varastoartikkelit (keräilyä varten)
luodaan, kun tilaus on valmis maksettavaksi. Kassan voi luoda:
  • Käsin tilauksesta (henkilökunta)
  • Itsepalveluna verkossa (asiakas)
Kassa on aina osa tilausta, ja siihen voi liittyä useita maksuja.
liittyy kassaan ja tuottaa alv-kuitin. Keskeiset ominaisuudet:
  • Osoittaa aina tilauksen rivitietoihin
  • Voi sisältää useita tapahtumia
  • Kassalla voi olla useita maksuja (esim. ennakko + loppusumma)
vastaa maksupäätteen kuittia. Yksi maksu voi sisältää useita tapahtumia.Esimerkkejä:
  • Jaettu maksu: puolet lahjakortilla, puolet käteisellä → 2 tapahtumaa, 1 maksu
  • Hyvitys: alkuperäinen veloitustapahtuma alkuperäisellä maksulla, hyvitystapahtuma siihen linkitetyllä hyvitysmaksulla

​
Maksutyypit ja -tavat

Jokaisella maksulla on tyyppi ja tapa, jotka kuvaavat, miten se maksettiin:
  • Tyypit: sale (veloitus), deposit_auth, deposit_capture, refund, refund_reverse (sinulle takaisin peritty hyvitys), cancel ja expire (lunastamatta rauennut pantin pidätys).
  • Manuaaliset tavat: Pay in store (PAY_STORE) ja kauppiaan itse nimeämät mukautetut tavat (CUSTOM) läsnäolo- ja offline-maksuihin.
  • Verkkomaksutavat: kortti, Apple Pay, Google Pay, MobilePay ja Pay by Bank Stripen kautta; kortti, Apple Pay ja Google Pay Adyenin kautta.
Maksun edetessä se kulkee pantin pidätyksen, veloituksen ja hyvityksen vaiheiden läpi. Jokaisella maksulla on tarkempi tila — pending, succeeded, partially refunded, refunded, refund reversed, cancelled tai expired. Tilauksen maksumerkintä tiivistää kaiken binääriseksi arvoksi Paid / Unpaid (paymentStatus: PAID / UNPAID).

​
Hierarkian visualisointi

​
Laskut

Maksujen rinnalla TWICE muodostaa laskuja — rahamallin suoritusasiakirjat. Maksurivi ilman laskuviitettä on laskuttamatonta rahaa: kun myynti onnistuu, TWICE muodostaa näistä riveistä laskun ja merkitsee muodostetun laskun tunnukset takaisin riveille. Maksurivi, joka jo viittaa laskuun, suorittaa kyseisen laskurivin eikä muodosta mitään uutta. Laskun status seuraa vain asiakirjan elinkaarta: draft, open, cancelled, uncollectible (manuaalinen alaskirjaus) tai scheduled (tuleva kestotilausjakso, laskettu pyydettäessä — ei koskaan tallennettu). Se, onko lasku maksettu, johdetaan erikseen laskun kentistä capturedTotal ja refundedTotal samaa sanastoa käyttäen kuin maksuissa: maksamaton, osittain maksettu, maksettu, osittain hyvitetty, hyvitetty. Kestotilausten myynti kertyy laskuriveiltä: jokainen laskutusjakso lisää rivin, joka sisältää kestotilauksen tunnuksen ja laskutuskauden, joten yksi lasku voi laskuttaa useita kestotilauksia. Katso Kestotilaukset.

​
Suhteet

  • Maksu viittaa aina niihin rivitietoihin, joita se veloittaa — ei koskaan koko tilaukseen abstraktisti.
  • Hyvitysmaksu linkittyy takaisin alkuperäiseen maksuun kentällä originalPaymentId. Hyvitysrivit jäljittyvät sisäisesti alkuperäisiin maksuriveihin (originalPaymentLineId); tätä rivikohtaista linkkiä ei näytetä API:ssa.
  • Pantti on tilauksella erillinen Payment-objekti (jolla on omat summat authorised, captured, refunded ja cancelled), joten panttiliikenne ei koskaan sekoitu veloitusliikenteeseen.
  • Maksupalveluntarjoaja (Adyen, Stripe, manuaalinen) määrittää, mitkä maksutavat ovat käytettävissä ja tuetaanko katevarausta ja veloitusta erikseen.

​
Elinkaari

​
Tilauksesta maksuun

1

Tilaus luodaan

Luodaan tilaus, joka sisältää . Tilauksia voi luoda käsin hallintapaneelissa tai automaattisesti asiakkaan verkkokassasta.Lue lisää: Tilauksen elinkaari
2

Kassa luodaan

Kun tilaus on valmis maksettavaksi, luodaan kassa — käsin hallintapaneelista tai verkkokaupan itsepalveluprosessin kautta. Kassa on aina linkitetty ylätason tilaukseen.
3

Maksut luodaan

Kassan sisällä luodaan yksi tai useampi maksu:
  • Jokainen maksu osoittaa tiettyihin rivitietoihin
  • Jokainen maksu tuottaa oman alv-kuittinsa
  • Useilla maksuilla hoidat osasuoritukset (ennakko + loppusumma, erämaksut)
4

Tapahtumat käsitellään

Jokainen maksu voi sisältää useita tapahtumia — jaettuja maksutapoja, hyvityksiä ja niin edelleen.

​
Pantin pidätys ja veloitus

Niillä palveluntarjoajilla, jotka sitä tukevat (Adyen ja Stripe korttimaksuissa), TWICE käyttää kaksivaiheista pantin pidätys–veloitus-prosessia:
  • Pantin pidätys: varaa varat kortilta ottamatta niitä. Käytetään vuokrausten noudoissa, jotta kauppias voi säätää lopullista summaa.
  • Veloitus: ottaa varatut varat. Voi olla täysi veloitus tai osittainen veloitus varattua summaa pienemmästä määrästä.
  • Peruutus: vapauttaa pantin pidätyksen veloittamatta. Käytetään, kun tilaus peruutetaan ennen noutoa.
  • Vanhentunut: palveluntarjoaja perui pantin pidätyksen automaattisesti, koska sitä ei veloitettu voimassaoloajan kuluessa (Stripellä tyypillisesti noin 7 päivää).

​
Pantit

Pantit ovat erillinen Payment-objekti varsinaisen veloituksen rinnalla. Tilauksella ne näkyvät omana lohkonaan, jolla on omat summat authorised, captured, refunded ja cancelled. Panttitapojen käytettävyys riippuu maksutavasta — PAY_STORE ja mukautetut manuaaliset tavat tukevat manuaalisia pantteja, kun taas korttitavat tukevat automaattisia korttipohjaisia pantteja.
Manuaaliset maksutavat (maksu noudettaessa, mukautetut tavat) ovat sallittuja kassalla myös silloin, kun tilaukseen sisältyy pantti. Tällöin pantti käsitellään manuaalisena panttina. Vain automaattisesti veloitettavia kestotilauksia sisältävät tilaukset edellyttävät korttimaksutapaa — pelkät pantit eivät.
Jos korttipohjaista pantin katevarausta ei veloiteta palveluntarjoajan voimassaoloajan kuluessa (Stripellä tyypillisesti noin 7 päivää), palveluntarjoaja peruu sen automaattisesti. Maksut-välilehdellä nämä näkyvät tilassa Expired, toisin kuin manuaalinen vapautus, joka näkyy tilana Peruutettu. Lisätietoa pantin pidätyksen vanhenemisesta: Pantit.

​
Osittaiset veloitukset ja osittaiset hyvitykset

Veloitetun tapahtuman voi hyvittää osittain useaan kertaan, kunnes se on hyvitetty kokonaan. Jokainen hyvitys luo uuden refund-tyyppisen maksutietueen, joka linkittyy alkuperäiseen maksuun kentällä originalPaymentId. Palveluntarjoaja voi peruuttaa hyvityksen (refund_reverse), esimerkiksi kun pankkihyvitys epäonnistuu ja raha palautuu sinulle. Veloittamatta rauennut pantin pidätys puolestaan tuottaa expire-tietueen. Kun teet hyvityksen:
  1. Määrität hyvitettävän tapahtuman ja kokonaissumman.
  2. Halutessasi määrität, mitkä maksurivit hyvitetään ja kuinka paljon riviä kohti.
  3. TWICE luo hyvitysmaksun ja päivittää alkuperäisen tapahtuman kentän modificationSummary.
Määrität tarkalleen, mitkä maksurivit hyvitetään ja kuinka paljon kultakin. Rivikohtaisten summien on vastattava yhteenlaskettuna hyvityksen kokonaissummaa. Rivin summan asettaminen arvoon null hyvittää kyseisen rivin koko jäljellä olevan hyvitettävän summan.Käyttötapaus: yhden tuotteen hyvittäminen monituotteisesta tilauksesta muihin koskematta.
Jätä maksurivit kokonaan pois. Hyvityssumma jaetaan suhteellisesti kaikille hyvitettäville riveille niiden jäljellä olevien hyvitettävien summien mukaan. Pyöristysjäännös menee suurimmalle riville.Käyttötapaus: kiinteän hyvän tahdon hyvityksen tekeminen tasaisesti jaettuna.
Alkuperäisen tapahtuman modificationSummary seuraa kahtatoista kenttää:
refundedTotal on karkea bruttoluku. Peruttu hyvitys palauttaa rahat sinulle, joten todellisuudessa hyvitetty summa on refundedTotal - refundReversedTotal. Pelkän refundedTotal-kentän lukeminen yliarvioi hyvityksen.
Hyvitykset käsitellään alkuperäisen maksupalveluntarjoajan kautta. Voit hyvittää vain tapahtumia, joiden tila on succeeded ja tyyppi capture.

​
Täsmäytys

Integroitujen palveluntarjoajien kohdalla TWICE täsmää tapahtumat maksuihin automaattisesti, linkittää maksut kassoihin ja tilauksiin ja päivittää tilauksen maksun tilan sitä mukaa kun tapahtumat valmistuvat.
Manuaalisissa maksuissa (käteinen, tilisiirto, kolmannen osapuolen alustat) kirjaa maksu ja tapahtuma suoraan. Käytä maksupäivän, maksutavan ja ulkoisen viitteen kenttiä täsmäytykseen kirjanpitoa vasten.
Kuitit muodostetaan maksua kohti, ei tapahtumaa kohti. Yksi maksu, jossa on kaksi tapahtumaa (lahjakortti + käteinen), tuottaa yhä yhden kuitin, joka kattaa molemmat maksutavat.

​
Tuetut palveluntarjoajat

TWICE tukee kahta verkkomaksupalveluntarjoajaa ja manuaalista prosessia kaikkeen muuhun.

​
Verkkomaksupalveluntarjoajat

Stripe ja manuaaliset/offline-maksut ovat kaikkien kauppojen käytettävissä. Adyen on käytössä vain valituilla kauppiailla (kuten myös SumUp läsnäolomaksupäätteille) — katso Maksuasetukset.

​
Apple Pay ja Google Pay Stripessä

Apple Pay ja Google Pay aktivoituvat automaattisesti, kun yhdistät Stripen ja otat korttimaksut käyttöön. Hallintapaneelissa ei ole kytkintä — lompakot johdetaan korttimaksutavasta ajonaikaisesti. TWICE rekisteröi verkkokauppasi verkkotunnukset (aliverkkotunnuksen ja mahdolliset mukautetut verkkotunnukset) Stripeen Apple Payn verkkotunnusvahvistusta varten. Rekisteröinti tapahtuu automaattisesti, kun:
  • Yhdistät Stripe-tilisi
  • Vaihdat kauppasi aliverkkotunnuksen
  • Otat mukautetun verkkotunnuksen käyttöön
Kassalla Stripe näyttää lompakkopainikkeet asiakkaan laitteen ja selaimen perusteella. Apple Pay näkyy Safarissa ja Applen laitteilla; Google Pay näkyy Chromessa ja Androidilla. Molemmat lompakot tukevat toistuvia maksuja (kestotilaukset) ja pantteja — Stripe tallentaa taustalla olevan kortin uudelleenkäytettäväksi maksutavaksi.
Apple Pay ei näy, kun kassa on upotettu iframeen. Tämä rajoitus ei koske Google Payta.

​
Manuaaliset / offline-maksut

Manuaalisia tapoja on kaksi:
  • Pay in store (PAY_STORE) — sisäänrakennettu tapa noudon yhteydessä perittävälle maksulle.
  • Mukautetut tavat (CUSTOM) — itse nimeämiäsi tapoja, joilla kullakin on oma nimi ja valinnainen kuvaus. Luo niitä niin monta kuin tarvitset — ”Tilisiirto”, ”Lahjakortti”, ”Ulkoinen kassajärjestelmä”.
Käytä niitä myymälästä kerättyyn käteiseen, TWICEn ulkopuolella saatuihin tilisiirtoihin, maksupäätteisiin, joita ei ole integroitu Adyenin tai Stripen kautta, sekä myymäläkrediittiin. Manuaaliset maksut tuottavat silti alv-kuitin, tukevat hyvityksiä (käsin syötettyinä) ja kertyvät tilauksen maksun tilaan täsmälleen samoin kuin verkkomaksut.

​
Usein kysytyt kysymykset

Maksun tasolla. Yksi maksu = yksi kuitti riippumatta siitä, kuinka monta tapahtumaa maksuun kuuluu. Jos asiakas maksaa 120 € jaettuna lahjakortin ja käteisen kesken yhdessä maksussa, kuitilla näkyy 120 € ja molemmat maksutavat eriteltyinä.
Hyvitykset tarvitsevat oman alv-kuittinsa ja kirjausketjunsa. Luomalla linkitetyn hyvitysmaksun (originalPaymentId → alkuperäinen maksu) TWICE pitää alkuperäisen tapahtuman muuttumattomana ja seuraa silti hyvitysketjua.
Kyllä. Aseta veloitussumma pantin pidätyksen summaa pienemmäksi; loppuosa vapautetaan — kyseessä on osittainen veloitus.
Et. Pantit käyttävät veloituksen rinnalla omaa Payment-objektiaan, jolla on oma pantin pidätys- ja veloituselinkaarensa. Näin raportointi ja hyvitykset pysyvät selkeinä.
Stripen ja Adyenin korttimaksut. Myös Apple Pay ja Google Pay Stripessä tukevat kestotilauksia — Stripe tallentaa taustalla olevan kortin toistuvia off-session-veloituksia varten. Uudelleenohjaukseen perustuvat tavat (MobilePay, Pay by Bank) ja manuaaliset tavat ovat vain kertaluonteisia.
Merkintä on koonti. Jokaisella maksulla on taustalla tarkempi tila — pending, succeeded, partially refunded, refunded, refund reversed, cancelled, expired; merkintä tiivistää tilauksen kaikki maksut binääriseksi arvoksi Paid / Unpaid (paymentStatus: PAID / UNPAID).

​
Kehittäjäviite

Tapahtumat on sidottu tilauksiin. Hyvitykset ja veloitukset löytyvät payments-päätepisteistä; palveluntarjoajien määritykset resurssista paymentAccounts.

API: Payments

Avaa päätepiste API-referenssissä.

​
Aiheeseen liittyvää

Tilauksen elinkaari

Tilauksen, maksun ja keräilyn tilat.

Tilaustyypit

Miten ostotyyppi muokkaa maksuprosessia.

Integraatiot

Yhdistä Stripe ja hallitse maksupalveluntarjoajia.

Raportit

Talousraportit ja täsmäytys.