Vent venligst ...


Loading...
Teknisk Dokumentation
Hjemmesider

Fakturadata

Fakturadata

Hvis du vil sende din kunde en kvittering fra Kvittering.dk/Storebox.com eller tilbyde fakturabetaling, fordelskort eller loyalitetskoncepter, så skal du implementere vores fakturadata.

Her beskriver vi, hvordan du bruger metoden. Det er samme logik, uanset om du skal opsætte fakturabetaling, fordelskort eller loyalitetskoncepter. 

Bemærk, at du skal have aftale med Klarna for at tilbyde fakturabetaling, og Storebox hvis du vil sende kvitteringsdata og tilbyde fordels/loyalitetkoncepter.

Fakturabetaling kan bruges som et supplement til almindelig kortbetaling og anvendes sammen med en aftale med en indløser.

Du er selv ansvarlig for at implementere Klarna i dit shopsystem. Når du har oprettet din konto ved én af udbyderne, skal du sende oplysningerne til os og integrere systemet med ePay ved hjælp af nedenstående parametre.


Sådan gør du

Her beskrives, hvordan du sender dine fakturadata til betalingsvinduet v2. Du skal bruge invoice-parameteren, hvis dine kunder skal kunne betale med Klarna.

Fakturadata styres med parameteren invoice sammen med de andre parametre til betalingsvinduet v2. Det skal defineres i JSON: http://www.json.org/

Bemærk! Parameteren amount skal matche fakturaens fulde beløb inkl. moms.

Eksempel: JSON

{
    "customer":{
       "emailaddress":"test@epay.dk",
       "firstname":"Jens",
       "lastname":"Jensen",
       "address":"Testervej 1",
       "zip":9000,
       "city":"Aalborg",
       "country":"Denmark"
    },
    "shippingaddress":{
       "firstname":"Jens",
       "lastname":"Jensen",
       "address":"Testervej 1",
       "zip":9000,
       "city":"Aalborg",
       "country":"Denmark"
    },
    "lines":[
       {
          "id":"6",
          "description":"MacBook",
          "quantity":1,
          "price":117057,
          "vat":25
       },
       {
          "id":"shipping",
          "description":"Shipping",
          "quantity":1,
          "price":700,
          "vat":25
       }
    ]
 }

Eksempel: Betalingsvinduet

<script type="text/javascript" src="https://ssl.ditonlinebetalingssystem.dk/integration/ewindow/paymentwindow.js" charset="UTF-8"></script>
 
 <script type="text/javascript">
 paymentwindow = new PaymentWindow({
     'merchantnumber': "YOUR-MERCHANTNUMBER-HERE",
     'windowstate': "1",
     'amount': "147196",
     'currency': "DKK",
     'orderid': "23",
     'invoice': '{"customer":{"emailaddress":"test@epay.dk","firstname":"Jens","lastname":"Jensen","address":"Testervej 1","zip":9000,"city":"Aalborg","country":"Denmark","shippingaddress":{"firstname":"Jens","lastname":"Jensen","address":"Testervej 1","zip":9000,"city":"Aalborg","country":"Denmark"}},"lines":[{"id":"6","description":"MacBook","quantity":1,"price":117057,"vat":25},{"id":"shipping","description":"Shipping","quantity":1,"price":700,"vat":25}]}'
 });
 </script>
 
 <input type="button" onclick="javascript: paymentwindow.open()" value="Go to payment" />

Invoice-parametre

NavnDatatypeKommentar
customerCustomerSe customer-parametre
shippingaddressShippingaddressSe customer shipping address-parametre
lines[]Lines arraySe invoice lines-parametre

Invoice customer-parametre

NavnDatatypeKommentar
referenceStringBruges ikke ved Klarna. Maks. 30 karakterer.
emailaddressStringMaks. 50 karakterer.
firstnameStringMaks. 255 karakterer.
lastnameStringMaks. 255 karakterer.
attention
StringMaks. 255 karakterer.
addressStringMaks. 255 karakterer.
zipStringMaks. 255 karakterer.
cityStringMaks. 255 karakterer.
countryStringMaks. 255 karakterer.
phoneStringMaks. 255 karakterer.

Invoice customer shipping address-parametre

NavnDatatypeKommentar
firstnameStringMaks. 255 karakterer.
lastnameStringMaks. 255 karakterer.
attentionStringMaks. 255 karakterer.
addressStringMaks. 255 karakterer.
zipStringMaks. 255 karakterer.
cityStringMaks. 255 karakterer.
countryStringMaks. 255 karakterer.
phoneStringMaks. 255 karakterer.

Invoice lines-parametre

NavnDatatypeKommentar
idStringDenne linjes identifikator fra dit eget system, f.eks. dit produkt-ID. Maks. 10 karakterer.
descriptionStringBeskrivelsen af denne linje, f.eks. produktnavnet. Maks. 40 karakterer.
textStringBruges til Kvittering.dk/Storebox. Fritekst under produktlinjen, fx produktspecifikationer. Maks. 64 karakterer.
priceIntegerStykprisen eksklusiv moms. Evt. rabat skal ikke fratrækkes. Beløbet skrives i mindste enheder. 
discount
DoubleRabatten i procent. 15 % skrives som 15.00 
quantityIntegerDenne linjes mængde.
vatDoubleMomsen i procent. 25 % skrives som 25.00

Eksempel: PHP

<?php
     $invoice["customer"]["emailaddress"] = "test@epay.dk";
     $invoice["customer"]["firstname"] = "Jens";
     $invoice["customer"]["lastname"] = "Jensen";
     $invoice["customer"]["address"] = "Testervej 1";
     $invoice["customer"]["zip"] = 9000;
     $invoice["customer"]["city"] = "Aalborg";
     $invoice["customer"]["country"] = "Denmark";
    
     $invoice["shippingaddress"]["firstname"] = "Jens";
     $invoice["shippingaddress"]["lastname"] = "Jensen";
     $invoice["shippingaddress"]["address"] = "Testervej 1";
     $invoice["shippingaddress"]["zip"] = 9000;
     $invoice["shippingaddress"]["city"] = "Aalborg";
     $invoice["shippingaddress"]["country"] = "Denmark";
    
     $invoice["lines"] = array();
 
     $invoice["lines"][] = array
         (
             "id" => "6",
             "description" => "MacBook",
             "quantity" => 1,
             "price" => 117057,
             "vat" => 25
         );
    
     $invoice["lines"][] = array
         (
             "id" => "shipping",
             "description" => "Shipping",
             "quantity" => 1,
             "price" => 700,
             "vat" => 25
         );
 ?>
 <script type="text/javascript" src="https://ssl.ditonlinebetalingssystem.dk/integration/ewindow/paymentwindow.js" charset="UTF-8"></script>
 
 <script type="text/javascript">
 paymentwindow = new PaymentWindow({
     'merchantnumber': "YOUR-MERCHANTNUMBER-HERE",
     'windowstate': "1",
     'amount': "147196",
     'currency': "DKK",
     'orderid': "23",
     'invoice': '<?php echo json_encode($invoice); ?>'
 });
 </script>
 
 <input type="button" onclick="javascript: paymentwindow.open()" value="Go to payment" />