Detaillierte Informationen zu den Transaktionstypen.

Klarna erlaubt:

• Buchungen (SALE), also direkte Zahlungen ohne vorherige Reservierung.
• Reservierungen (AUTH), auch Pre-Authorization genannt, um einen Betrag vorab zu reservieren und später ganz oder teilweise zu buchen.
• Captures, also Buchungen auf eine vorherige Reservierung, wobei Klarna mehrere Teil-Captures erlaubt, die aber insgesamt die Summe des reservierten Betrags nicht überschreiten dürfen.
  Beispiel: Reservierung über 20,00 EUR, 1 Capture über 5,00 EUR, 1 weiterer Capture über 15,00 EUR.
  Es muss nicht unbedingt der volle Betrag einer Reservierung gebucht werden. Bleibt am Ende ein Rest übrig, kann dieser über einen Void wieder freigegeben werden.
• Void oder Reversal (auch Stornierung), erlaubt die Freigabe eines reservierten Betrags oder Restbetrags, so dass dieser dem Kunden wieder zur Verfügung steht. Wir schon unter Capture im Beispiel gezeigt, ist die Freigabe eines Teilbetrags der Reservierung möglich.
• Erstattung (Refund), erlaubt die Rückzahlung eines gebuchten Betrags oder eines Teilbetrags an den Kunden. Die Summe der Teilerstattungen darf den Betrag der ursprünglichen Buchung nicht übersteigen. Es sind aber mehrere Teilerstattungen erlaubt, solange diese Summe nicht überschritten wird. Reservierungen können nicht erstattet werden, sondern nur storniert (=Void).

Durch eine erfolgreiche Initialisierung wird eine Referenznummer erstellt sowie ein Weiterleitungslink (redirect) an den Händler übermittelt. Der übermittelte Link führt zum Bezahlformular. Der Kunde muss an diese URL weitergeleitet werden. Dies kann durch einen HTTP-Redirect-Header, eine HTML-Seite mit entsprechendem Meta-Tag oder Javascript erfolgen.

Bereitzustellen von: GiroCheckout
Aufzurufen von: Händler

1. Käufer wählt Zahlart Klarna aus
2. Shop initiiert Klarna-Transaktion (Initialisierung)
3. GiroCheckout initialisiert Transaktion bei Rechenzentrum
4. Rechenzentrum übermittelt Ergebnis an GiroCheckout
5. Shop bekommt Rückmeldung über Initialisierungsausgang (bei Fehler ist Transaktion beendet)
6. Shop sendet Redirect URL an Kundenbrowser
7. Kundenbrowser leitet zum Rechenzentrum weiter
8. Rechenzentrum zeigt Zahlformular an
9. Kunde autorisiert Transaktion
10. Rechenzentrum führt Transaktion durch
11. Rechenzentrum übermittelt Ergebnis an GiroCheckout
12. Notification: GiroCheckout benachrichtigt Shop über Transaktionsausgang (Benachrichtigung)
13. Notification: Shop verarbeitet Transaktionsausgang
14. Notification: Shop sendet HTTP Statuscode an GiroCheckout
15. Kunde klickt „Zurück zum Shop“ beim Rechenzentrum oder wartet die automatische Weiterleitung ab (Rücksprung)
16. GiroCheckout leitet Kunden zurück an den Shop

Wie im Workflow zu sehen ist, gibt es unterschiedliche API-Aufrufe während einer Klarna-Transaktion. Das Formular, das der Käufer nach Weiterleitung zum Rechenzentrum ausfüllt, wird von Klarna zur Verfügung gestellt und verarbeitet und kann sich im Inhalt und Ablauf je nach Shopeinstellungen oder Käufersituation ändern.

1. Transaktion initialisieren
2. Ausfüllen der Formulare bei Klarna durch den Käufer
3. Benachrichtigung des Zahlungsergebnisses an den Händler
4. Zurückleitung des Käufers auf die Händlerseiten (ausgelöst durch Käufer oder automatisch)

URL https://payment.girosolution.de/girocheckout/api/v2/transaction/start

Diese Objektstruktur gilt sowohl für die Rechnungsadresse (billingAddress) als auch für die Lieferadresse (shippingAddress).

phone_contact Objekt:

contacts-Objekt:

Hier kann im Objekt phone_contacts ein Array mit mehreren Elementen mit den folgenden Feldern angegeben werden:

personal_identifications-Objekt:

Hier kann ein Array mit mehreren Elementen mit den folgenden Feldern angegeben werden:

shipping_costs und basket_discount

basket_items Liste:

Ein Array mit folgenden Feldern:

quantity-Objekt:

unit_price-Objekt:

item_discount-Objekt:

  basket:
  {
    "basket_id": "basket123456",
    "basket_type": "PHYSICAL",
    "basket_items": [
      {
        "name": "Item 1",
        "quantity": {
          "quantity_amount": 3,
          "quantity_unit": "pcs"
        },
        "unit_price": {
          "net": 500,
          "gross": 600,
          "currency": "EUR",
          "tax": 2000
        }
      }
    ]
  }
  
  billing_address: 
  {
    "title": "Herr",
    "first_name": "Max",
    "last_name": "Mustermann",
    "company_name": "Acme GmbH",
    "email": "maxi.muster@example.com",
    "phone_contact": {
      "phone_type": "MOBILE",
      "phone_number": "+491701234567"
    },
    "address_line_1": "Mustergasse 123",
    "address_line_2": "Haus A",
    "address_line_3": "Wohnung 12",
    "postal_code": "88888",
    "city": "Berlin",
    "state": "Berlin",
    "country": "DE"
  }
  
  shipping_address: 
  {
    "title": "Herr",
    "first_name": "Max",
    "last_name": "Mustermann",
    "company_name": "Acme GmbH",
    "email": "maxi.muster@example.com",
    "phone_contact": {
      "phone_type": "HOME",
      "phone_number": "+49755283492987"
    },
    "address_line_1": "Musterstr. 1a",
    "postal_code": "88888",
    "city": "Berlin",
    "state": "Berlin",
    "country": "DE"
  }
  
  customer_information: 
  {
    "customer_id": "CUST123456",
    "date_of_birth": "1985-06-15",
    "gender": "MALE",
    "title": "Herr",
    "personal_identifications": [
      {
        "type": "PASSPORT",
        "id": "A1234567",
        "issued_by": "DE"
      },
      {
        "type": "DRIVERS_LICENSE",
        "id": "DL78901234",
        "issued_by": "Bayrisches Verkehrsministerium"
      }
    ],
    "contacts": {
      "phone_contacts": [
        {
          "phone_type": "HOME",
          "phone_number": "+442071838750"
        }
      ]
    }
  }
}

Die Antwort besteht aus einem JSON Objekt. Das Feld rc liefert einen Fehlercode zurück. Wird rc = 0 zurückgeliefert, wurde die Transaktion erfolgreich initialisiert. Sie bekommen als Antwort eine Transaktionsnummer und die redirectURL zum Klarna-Formular zurück.

Der Ausgang einer Zahlung wird an die im urlNotify Parameter angegebene URL übermittelt. Diese Rückmeldung dient dazu, dem Händler den Ausgang der Transaktion mitzuteilen. Durch diese Information kann der Transaktionsstatus beim Händler geändert werden.

Der Zahlungsausgang einer Transaktion steht im Feld gcResultPayment.

URL: notifyUrl aus der Transaktionsinitialisierung
Bereitzustellen von: Händler
Aufzurufen von: GiroCheckout

Als Antwort auf den GET-Request wird einer der folgenden HTTP Statuscodes erwartet.

Nach Beendigung der Zahlung kann der Kunde über einen Link zurück zum Händler kommen. Eine Weiterleitung erfolgt erst, wenn der Käufer den „Abbrechen“ oder „Zurück zum Shop“ Button drückt oder automatisch nach einigen Sekunden.

URL: redirectUrl aus der Transaktionsinitialisierung
Bereitzustellen von: Händler
Aufzurufen von: GiroCheckout

Diese Transaktionen referenzieren auf eine zuvor erfolgte Transaktion. Die Transaktion basiert auf einer Server-zu-Server-Kommunikation und erfordert keine Kundenaktion (Eingabe von Daten).

Bereitzustellen von: GiroCheckout
Aufzurufen von: Händler

1. Shop sendet Anfrage mit referenzierter Klarna-Transaktion
2. GiroCheckout leitet Transaktion zu Rechenzentrum
3. Rechenzentrum übermittelt Ergebnis an GiroCheckout
4. Shop bekommt direkte Rückmeldung über Transaktionsausgang (keine Notification)

URL CAPTURE: https://payment.girosolution.de/girocheckout/api/v2/transaction/capture
URL REFUND: https://payment.girosolution.de/girocheckout/api/v2/transaction/refund
URL VOID: https://payment.girosolution.de/girocheckout/api/v2/transaction/void

Die Antwort besteht aus einem JSON Objekt. Das Feld rc liefert einen Fehlercode zurück. Wird rc = 0 zurückgeliefert, wurde die Transaktion erfolgreich initialisiert. Sie bekommen als Antwort eine Transaktionsnummer und weitere Informationen zurück.