Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 3 Next »

Maksutavat

Asiakas valitsee itse, mitkä maksutavat haluaa ottaa käyttöön tarjottavan maksuratkaisun kautta. Korttimaksut ja rahoituspalvelut edellyttävät myönteistä luototuspäätöstä. Verkkokaupan tai - palvelun koko rahaliikenne kulkee Svea Paymentsin hallinnoimien asiakasvaratilien kautta (pl. tekniset maksutavat), jolloin asiakas voi hyödyntää Svea Paymentsin palvelukokonaisuuden kehittyneitä ominaisuuksia mm. tilityksiin, täsmäytyksiin ja raportointiin sekä palautusten hallintaan liittyen.

Maksutapavalikoimaa ja maksuprosesseja voidaan räätälöidä asiakkaan muuttuvien tarpeiden mukaisesti. Kaikki Svea Paymentsin loppukäyttäjälle / ostajalle suunnatut käyttöliittymät on toteutettu responsiivisina huomioiden palveluiden käytön mobiilisti.

Oman integraation ollessa kyseessä verkkokauppa voi hakea maksutavat verkkokaupan kassalle käyttäen tätä rajapintaa: (TODO: LINKKI). Tällöin Svean rajapinta palauttaa kassalle aina palveluun aktivoidut ja käytettävissä olevat maksutavat (huomioiden mm. mahdolliset summarajat) sekä ajantasaiset maksutapojen logot.

Maksaminen

Maksuprosessi, kun maksutapa valitaan Svea Paymentsin maksutavan valintasivulla:

  1. Maksaja valitsee Svea Paymentsin verkkokaupan kassalla.

  2. Verkkokauppa välittää tilauksen ja maksun tiedot Svea Paymentsille:

    1. Kauppa kutsuu Svean rajapintaa NewPaymentExtended.pmt:

      1. → Pyyntö: http://docs.sveapayments.fi/api/payment-api/payment/s2s-api/ (TODO: LINKKI) , S2S basic auth, Parametrit: (TODO: LINKKI) http://docs.sveapayments.fi/api/payment-api/payment/create-payment/

      2. ← Vastaus: XML, jonka sisällä maksulinkki

    2. Jos verkkokauppa käyttää Ostajan apulainen -palvelua, tulee maksupyynnön sisältää parametri pmt_escrow=Y.

    3. Jos verkkokauppa ei käytä Ostajan apulainen -palvelua, tulee maksupyynnön sisältää parametri pmt_escrow=N.

  3. Kauppa ohjaa ostajan selaimen maksulinkkiin. Maksajalle näytetään Svea Paymentsin maksutavan valintasivu, josta ostaja valitsee haluamansa maksutavan (sivulla näytetään ne maksutavat, jotka palveluun on aktivoitu ja jotka ovat ostoksen summan perusteella valittavissa). Sivun ulkoasu on brändättävissä verkkokaupan brändillä.

  4. Ostaja suorittaa maksun.

  5. Ostaja palaa kaupan antamaan OK-urliin.

  6. Kauppa tarkistaa OK-pyynnön saatuaan oliko tilauksen maksu jo aiemmin vahvistettu. Jos ei ollut, voidaan se nyt vahvistaa Svean tilan kyselyn kautta:

Maksuprosessi, kun maksutapa valitaan verkkokaupassa:

Verkkokauppa voi näyttää valittavissa olevat maksutavatostajalle jo verkkokaupan kassalla. Tässä mallissa ei käytetä Svea Paymentsin maksutavan valintasivua. Kun maksutapa valitaan verkkokaupassa, on prosessi seuraavanlainen:

  1. Kauppa kyselee maksutavat Svealta ja näyttää ne kassalla

    1. → Pyyntö: http://docs.sveapayments.fi/api/payment-api/retrieve-available-payment-methods/ (TODO: LINKKI)

    2. ← Vastaus: XML-lista maksutavoista. Ostoksen summa vaikuttaa siihen mitä maksutapoja palautetaan, sillä maksutavoilla on minimi- ja maksimisummia maksulle tai luoton määrälle.

      1. Jos verkkokauppa käyttää Ostajan apulainen -palvelua, palautetaan vastauksessa myös linkki Ostajan apulaisen ehtoihin, jotka verkkokaupan tulee näyttää ostajalle niin että ostaja hyväksyy ne ennen maksamista.

  2. Ostaja valitsee maksutavan kassalla.

  3. Kauppa välittää tilauksen ja maksun tiedot Svea Paymentsille:

    1. Kauppa kutsuu Svean rajapintaa NewPaymentExtended.pmt:

      1. → Pyyntö: http://docs.sveapayments.fi/api/payment-api/payment/s2s-api/ (TODO: LINKKI) , S2S basic auth, Parametrit: (TODO: LINKKI) http://docs.sveapayments.fi/api/payment-api/payment/create-payment/ (TODO: LINKKI)

      2. ← Vastaus: XML, jonka sisällä maksulinkki

    2. Pyynnön tulee sisältää valitun maksutavan maksutapakoodi (pmt_paymentmethod)

    3. Jos verkkokauppa käyttää Ostajan apulainen -palvelua, tulee maksupyynnön sisältää parametri pmt_escrow=Y.

    4. Jos verkkokauppa ei käytä Ostajan apulainen -palvelua, tulee maksupyynnön sisältää parametri pmt_escrow=N.

  4. Kauppa ohjaa ostajan selaimen maksulinkkiin.

    1. Joissain tilantessa ostaja käy Svea Paymentsin sivulla, esim. tunnistautumassa; tämän sivun ulkoasu on brändättävissä verkkokaupan brändillä.

  5. Ostaja suorittaa maksun.

  6. Ostaja palaa kaupan antamaan OK-urliin.

  7. Kauppa tarkistaa OK-pyynnön saatuaan oliko tilauksen maksu jo aiemmin vahvistettu. Jos ei ollut, voidaan se nyt vahvistaa Svean tilan kyselyn kautta:

    1. Kauppa varmistaa tilan kyselyllä Svealta että maksu oli oikeasti vahvistettu

      1. → Pyyntö: http://docs.sveapayments.fi/api/payment-api/payment-status-query/status-query/ (TODO: LINKKI)

      2. ← Vastaus: Tieto oliko maksu vahvistettu. Ks. kohta Maksun tilan kysely

    2. Kauppa merkitsee tilauksen maksetuksi jos kysely sen vahvisti

S2S-lasku & S2S-yrityslasku

  • S2S-laskulla ja S2S-yrityslaskulla voidaan luoda Lasku kuluttajalle tai Yrityslasku yritykselle tai yhdistykselle. Tässä ei käytetä mitään Svean käyttöliittymää.

  • Pyyntö rajapintaan tekee luottopäätöksen ja luo tilauksen odottamaan laskutusta Svean palveluun.

  • Kauppiaalla on velvoite tunnistaa ostaja.

  1. Kauppa kutsuu Svean S2S-laskun rajapintaa

    1. →  Pyyntö: http://docs.sveapayments.fi/api/recurring-payment-api/svea-s2s-invoice/   /   NewChargeWithTokenActionExtended (TODO: LNKKI)

    2. ←  Vastaus

      1. OK: Luottopäätös läpi.

        1. Maksutapahtuma on valmis laskutettavaksi kun kauppa haluaa sen tehdä. Laskuttaminen tapahtuu toimitustiedot välittämällä. Ks. Toimittaminen/Laskuttaminen (TODO: LINKKI)

        2. Mahdollista konfiguroida palvelu Svealla myös siten, että lasku lähetetään Svealta heti tai tietyn viiveen jälkeen.

      2. VIRHE: Luottopäätös ei mennyt läpi tai tuli tekninen virhe.

      3. EPÄSELVÄ: Esim. timeout-tilanne: Kauppa voi myöhemmin kysellä tilan kyselyllä menikö luottopäätös läpi ja syntyikö siten maksutapahtuma joka voidaan myöhemmin laskuttaa.

S2S-erämaksu

  • S2S-erämaksulla voidaan luoda kuluttajalle Erämaksu-tyyppinen tilaus. Tässä ei käytetä mitään Svean käyttöliittymää.

  • Pyyntö rajapintaan tekee luottopäätöksen ja luo tilauksen odottamaan laskutusta Svean palveluun.

  • Kauppiaalla on velvoite tunnistaa ostaja.

  1. Kauppa hakee Svealta Erämaksulle käytettävissä olevat maksusuunnitelmat

    1. → Pyyntö: http://docs.sveapayments.fi/api/recurring-payment-api/svea-s2s-part-payment/   / Get Part Payment Plans / GetSveaPaymentPlanInformation.pmt (TODO: LINKKI)

    2. ← Vastaus: Valittavissa olevat maksusuunnitelmat eri maksuajoilla ja ehdoilla sekä erämaksuun liittyvät ehtodokumentit

  2. Kauppa näyttää ostajalle tai kassahenkilölle valittavissa olevat maksusuunnitelmat

  3. Ostaja tai kassahenkilö valitsee maksusuunnitelman ja syöttää muut tarvittavat tiedot (HETU, sähköposti yms.)

  4. Kauppa kutsuu Svean S2S-erämaksun rajapintaa

    1. → Pyyntö: http://docs.sveapayments.fi/api/recurring-payment-api/svea-s2s-part-payment/    /  Calling Payment API / NewChargeWithTokenActionExtended.pmt (TODO: LINKKI)

    2. ← Vastaus

      1. OK: Luottopäätös läpi.

        1. Maksutapahtuma on valmis laskutettavaksi kun kauppa haluaa sen tehdä. Laskuttaminen tapahtuu toimitustiedot välittämällä. Ks. Toimittaminen/Laskuttaminen (TODO: LINKKI)

        2. Mahdollista konfiguroida palvelu Svealla myös siten, että lasku lähetetään Svealta heti tai tietyn viiveen jälkeen.

      2. VIRHE: Luottopäätös ei mennyt läpi tai tuli tekninen virhe.

      3. EPÄSELVÄ: Esim. timeout-tilanne: Kauppa voi myöhemmin kysellä tilan kyselyllä menikö luottopäätös läpi ja syntyikö siten maksutapahtuma joka voidaan myöhemmin laskuttaa.

Logot

Lataa tästä Svean logot (TODO: LINKKI)

  • No labels