...

Oman integraation ollessa kyseessä verkkokauppa voi hakea maksutavat verkkokaupan kassalle käyttäen Get Payment https://sveapayments.atlassian.net/wiki/spaces/DOCS/pages/1657012326/Retrieve+Available+Payment+Methods#Get-Payment-Methods -rajapintaa. Tällöin Svean rajapinta palauttaa kassalle aina palveluun aktivoidut ja käytettävissä olevat maksutavat (huomioiden mm. mahdolliset summarajat) sekä ajantasaiset maksutapojen logot.

...

Materiaalit, kuten logot, mainosbannerit ja maksutapakuvaukset verkkokauppaan löydät täältä: Materiaalit .

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ö: https:Create Payment - Svea Payments API Integration Guidelines - Svea Payments (atlassian.net//sveapayments.atlassian.net/wiki/spaces/DOCS/pages/1657012476/Create+Payment#Request-(S2S-HTTP-POST), S2S basic auth.

         • Parametrit: http://docs.sveapayments.fi/api/payment-api/payment/create-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:

   • Kauppa varmistaa tilan kyselyllä Svealta että maksu oli oikeasti vahvistettu

     1. → Pyyntö: https://sveapayments.atlassian.net/wiki/spaces/DOCS/pages/1657012590/Request+and Response - Svea Payments API Integration Guidelines - Svea Payments (atlassian.net+Response#Request-(S2S-HTTP-POST)

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

   • Kauppa merkitsee tilauksen maksetuksi jos kysely sen vahvisti

...

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

   1. → Pyyntö: https://sveapayments.atlassian.net/wiki/spaces/DOCS/pages/1657012326/Retrieve+Available+Payment Methods+Methods#REQUEST

   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ö: https:Create Payment - Svea Payments API Integration Guidelines - Svea Payments (atlassian.net//sveapayments.atlassian.net/wiki/spaces/DOCS/pages/1657012476/Create+Payment#Request-(S2S-HTTP-POST) , S2S basic auth.

         • Parametrit: Create Payment - Svea Payments API Integration Guidelines - Svea Payments (atlassian.net)

      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ö: https://sveapayments.atlassian.net/wiki/spaces/DOCS/pages/1657012590/Request+and Response - Svea Payments API Integration Guidelines - Svea Payments (atlassian.net+Response#Request-(S2S-HTTP-POST)

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

   2. Kauppa merkitsee tilauksen maksetuksi jos kysely sen vahvisti

...

Lue S2S laskun, yrityslaskun ja erämaksun maksuprosessista täältä: S2S Lasku, yrityslasku ja erämaksu .

Maksun vahvistuksen call-back: Suositeltavaa toteuttaa aina

1. Ostaja on maksanut maksun. Ostaja on saattanut palata selaimella kauppaan tai sitten ei.

2. Maksun vahvistuksen saamisen jälkeen Svea tekee kaupan OK-urliin server-to-server-kutsun

   1. Tulee 1 minuutin viiveellä suhteessa siihen kun maksun vahvistus on saatu Svealle ja ostaja on mahdollisesti ohjattu kauppaan

3. Kauppa tarkistaa call-back 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ö: https://sveapayments.atlassian.net/wiki/spaces/DOCS/pages/1657012590/Request+and Response - Svea Payments API Integration Guidelines - Svea Payments (atlassian.net+Response#Request-(S2S-HTTP-POST)

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

   2. Kauppa merkitsee tilauksen maksetuksi jos kysely sen vahvisti

...

• Yleisohjeita: Payment Status Query

• Maksun tilan kyselyllä voi varmistaa että maksu oli todella maksettu kun ostaja palaa kaupan OK-urliin tai Svea kutsuu kaupan OK-urlia call-back-tyyppisesti.

• Lisäksi tilan kyselyä voi tehdä ajastetusti. Tämä ei kuitenkaan ole suositeltavaa eikä tarpeellista mikäli kauppa tukee call-backeja Svealta.

1. → Pyyntö: https://sveapayments.atlassian.net/wiki/spaces/DOCS/pages/1657012590/Request+and Response - Svea Payments API Integration Guidelines - Svea Payments (atlassian.net+Response#Request-(S2S-HTTP-POST)

2. ← Vastaus: https://sveapayments.atlassian.net/wiki/spaces/DOCS/pages/1657012590/Request+and Response - Svea Payments API Integration Guidelines - Svea Payments (atlassian.net+Response#Response-(XML)

   1. Maksettu: 20,30,40,91,92,93,95,98 (Mitä tahansa 20 .. 98).

   2. EI maksettu: 00,01,10,11,15,19  (Mitä tahansa 00 ... 19)

   3. 99 on kokonaan peruutettu, joten tilausta ei kannata merkitä maksetuksi vaikka se voi olla käynytkin maksettu-tilassa ennen tähän tilaan päätymistä.

...