API Overview

Klarna Integration Developer Guide
- Recent Revisions to This Document
- VISA Platform Connect: Specifications and Conditions for Resellers/Partners

Introduction to Klarna Integration
- Merchant Account Types

Overview of Processing Klarna Transactions
- HOP Session Workflow
- Inline Session Workflow
- Widget Installation for Inline Workflow
- Refunding a Payment Workflow
- Reversing an Authorized Payment Workflow
- Transaction Statuses Workflow

Klarna API Requests
- Creating a HOP Session
  - Requesting to Create a HOP Session
  - XML Example: Creating a Session
- Creating an Inline Session
  - Requesting to Create an Inline Session
  - XML Example: Creating a Session
- Updating a Session
  - Required Fields for Updating a Session
    - Coupon Fields
  - Optional Fields for Updating a Session
  - XML Example: Updating a Session
- Authorize a Payment
  - Required Fields for an Authorization
  - XML Example: Authorization
- Update an Authorized Payment
  - Required Fields for Updating an Authorization
  - Example: Updating an Authorized Payment
- Reverse an Authorized Payment
  - Required Fields for Authorization Reversal
  - XML Example: Authorization Reversal
- Capture a Payment
  - Required Fields for a Capture
  - Optional Fields for a Capture
  - XML Example: Capture
- Refund a Payment
  - Required Fields for a Refund
  - Optional Fields for a Refund
  - XML Example: Refund
- Check a Request Status
  - Required Fields for Check Status
  - XML Example: Check Status

Reference Information
- Calculating the Grand Total Amount
- Using Line Items
- Reason Codes and Klarna Response Codes
- Klarna Chargebacks
- Generating Reports Using the Business Center
- Simple Order API Field Map

Refund a Payment

Refunding a payment returns the entire captured amount or part of the captured amount to the customer's account. Klarna supports multiple refund requests when the total amount of all refunds is less than the captured amount.'

Cybersource recommends using the optional fields for a refund to ensure the request is successful. For more information, see Optional Fields for a Refund.

Endpoints

Set the

apRefundService_run

field to

true

, and send the request to one of these endpoints:

Production:

https://ics2ws.ic3.com/commerce/1.x/transactionProcessor

Test:

https://ics2wstest.ic3.com/commerce/1.x/transactionProcessor

Response Statuses

The refund service responds with one of these statuses as the

apRefundReply_status

field value:

FAILED

: The refund request is not successful. Send a new refund request. A failed request can be due to either Klarna rejecting the transaction or a technical error.

PENDING

: The refund request is accepted but is not refunded. Request the check status service to retrieve status updates. For more information, see Check a Request Status.

REFUNDED

: The captured payment is successfully refunded.