Klarnan osCommerce-moduulin asentaminen

1. Lataaminen

Lataa osCommerce-moduuli Downloads -kohdasta ja valitse Modules.

2. Tiedostojen siirtäminen

Siirrä tiedostot FTP-ohjelmalla kohteeseen, jossa osCommerce-kauppasi on. Zip-tiedosto on muodostettu niin, että voit siirtää Includes- ja Images-kansiot vastaaviin palvelimella oleviin kansioihin. Kun valitset Korvaa kaikki tiedostot, tiedostot siirtyvät oikeille paikoilleen. Tämä toimenpide ei vaikuta muihin kuin Klarna-tiedostoihin.* HUOM! Jos olet tehnyt muutoksia osCommerce-kauppasi tiedostorakenteeseen, kaikki tiedostot eivät ehkä siirry oikeille paikoilleen, sillä siirto perustuu vakiotiedostorakenteeseen.

*Siirto korvaa mahdolliset aiemmat Klarna-tiedostot. Tietokannassa olevat asetukset säilytetään.

3. Asetukset

Klarnan maksumoduulit ovat Admin-hallinto-osan kohdassa Modules (Moduulit) ? Payment (Maksu). Huomaa, että kullakin maalla on oma maksumoduulinsa.

4. Lasku

Lasku-moduulin nimi on Klarna Lasku, ja se sisältää seuraavat asetusmahdollisuudet:

Merchant ID on Estore ID -tunnus, jonka olet saanut Klarnalta, ja Shared secret on Klarnan tarjoama jaettu salasana.
"Product artno attribute"-kohdassa näkyvät laskun Tuotenumero -kentässä näytettävät tiedot. Id tarkoittaa, että kentässä näkyy luku, ja Model tarkoittaa, että kentässä näkyy tuotteen malli.
Enable Auto Activate -palvelua käytettäessä Klarna aktivoi laskun heti, kun ostos on tehty, ja lähettää laskun kirjeitse asiakkaalle. Palvelusta on sovittava erikseen Klarnan kanssa, ennen kuin se voidaan ottaa käyttöön.
Activate delay -kohdassa voit määrittää, kuinka monen päivän kuluttua tilauksesta lasku aktivoidaan, mikäli olet saanut automaattisen aktivointipalvelun käyttöoikeuden.
Pre-populate personnumer field -kohdassa määritetään, yrittääkö moduuli täyttää henkilönumeron tietokannasta vai ei. Jos kaupalle ei ole valittu henkilötunnustoimintoa, ei ole suositeltavaa valita etukäteen mitään arvoa.
Credit limit -kohdassa määritetään, mitä tilauksia Klarnan maksupalvelu näyttää vaihtoehtoisesti. Jos tilaus ei ylitä määritettyä luottorajaa, maksuvaihtoehtona näkyy Klarna. Huomaa, että toiminto ei välttämättä toimi ongelmitta, sillä vertailu tehdään ostoskorissa olevien tuotteiden arvon perusteella ottamatta huomioon rahtia ja mahdollisia laskutuskuluja. Arvo ilmoitetaan äyreinä.

Luottorajasta sovitaan kaupan ja Klarnan kesken. Klarna ei hyväksy luottorajan ylittäviä ostoksia kauppakohtaisesti määritetystä luottorajasta huolimatta. Tämän asetuksen tarkoituksena on ainoastaan estää Klarnan virheilmoituksen lähettäminen asiakkaalle, mikäli ostos ylittää luottorajan.
Ignore table -kohdassa on luettelo niistä Order Total -kohdan moduuleista, jotka eivät aiheuta uusia kuluja tai oikeuta alennuksiin. Nämä kustannukset tai alennukset eivät tule mukaan laskuun. Kaikki kohtien ot_tax, ot_total ja ot_subtotal merkinnät ohitetaan oletusarvoisesti, sillä ne eivät aiheuta uusia kuluja tai oikeuta uusiin alennuksiin.
Payment Zone -kohdassa voidaan rajoittaa aluetta, jolla palvelu on saatavilla. Huomaa, että Klarna hyväksyy vain suomalaiset ostajat. Vaikka myös muualla kuin Suomessa virallisesti asuvat henkilöt voisivat valita palvelun, näiden asiakkaiden ostoksia ei käsitellä.
Tax Class tarkoittaa näiden lisämaksujen veroluokkaa. Toiminto ei laske hintaan lisättävää veroa vaan määrittää, miten suuri osa lisämaksujen summasta muodostuu veroista.

Tähän kohtaan voidaan liittää myös luettelo maksuista, jotka eivät sisällä veroja. Ilmoita meille, jos laskuissasi käytetään tällaisia lisäkuluja.
Sort order of Display -kohdassa määritetään, missä järjestyksessä moduulit näytetään kassalla (0 = ensimmäinen).
Huomaa, että Klarna hyväksyy ainoastaan Euroissa (EUR) suoritetut maksut. Moduuli vahvistaa, että maksuvaluutan arvona on $currency == "EUR". Jos käytät järjestelmää, joka ei aseta valuutaksi ($currency) arvoa "EUR", asetuksia on ehkä muutettava kohdassa modules/payment/kreditor.php. Huomaa, että $currency-tarkastus tehdään kahdessa eri kohdassa koodin mukaisesti.

5. Klarna-osamaksu

Klarna-osamaksumoduulin nimi on Osamaksu - Klarna. Asetukset ovat täysin samat kuin laskujen yhteydessä. Ainut ero on, että käyttäjän on napsautettava "Click here to update your pclasses" -painiketta Merchant ID - ja Shared secret -kohtien tallentamisen jälkeen. Kun napsautat tätä painiketta, pclass-asetukset haetaan automaattisesti Klarnan järjestelmästä.

6. Kuukausimaksujen näyttäminen tuotesivulla

Voit näyttää kuukausimaksut tuotesivulla ja ostoskorissa muuttamalla seuraavia osCommerce-kaupan asetuksia.

1. Avaa \catalog\product_info.php. Jos käytössä on tavallinen osCommerce-näkymä, riveillä 89–96 näkyy seuraava koodi:

      <tr>
        <td><table border="0" width="100%" cellspacing="0" cellpadding="0">
          <tr>
            <td class="pageHeading" valign="top"><?php echo $products_name; ?></td>
            <td class="pageHeading" align="right" valign="top"><?php echo $products_price; ?></td>
          </tr>
        </table></td>
      </tr>

Kopioi ja liitä seuraava koodi suoraan edellä mainitun koodin alapuolelle:

<?php include DIR_WS_INCLUDES . 'display_klarna_price.php';?>

Tallenna tiedostot tämän jälkeen.

2. Jos haluat näyttää tiedot myös ostoskorissa, avaa tiedosto \catalog\includes\boxes\shopping_cart.php. Seuraava koodirivi näkyy noin riveillä 59–61:

  if ($cart->count_contents() > 0) {
    $info_box_contents[] = array('text' => tep_draw_separator());
    $info_box_contents[] = array('align' => 'right',
                                 'text' => $currencies->format($cart->show_total()));

Kopioi ja liitä seuraava koodi suoraan edellä mainitun koodin alapuolelle:

include DIR_WS_INCLUDES . 'display_klarna_cart.php';

7. Testaus

Voit testata ostosten tekemistä testihenkilöidemme avulla. Tee muutamia ostoksia käyttämällä hyväksyttyä ja hyväksymätöntä testihenkilöä, jotta näet, miten moduuli toimii. Tarkista tämän jälkeen, että laskut on toimitettu Klarnalle, kirjautumalla Klarna online -sivustoon ja hakemalla sen jälkeen laskut. Valitse Näytä testilaskut -kohdassa vaihtoehto Kyllä.

Nyt olet valmis käyttämään Klarnan palveluita.

Muista myös poistaa Klarna Online -sivuston testikäyttötila käytöstä, kun olet valmis!

Klarna integration guide