Klarna Docs - Managing Klarna orders with Vtex
API and SDKsSupport
Managing Klarna orders with Vtex

This section explains how to capture payments, process refunds, cancel transactions, and release uncaptured amounts through the VTEX back office.

Once Klarna has authorized a payment, you can manage the order through VTEX. The following actions are supported:

  • Capture:

    • Finalizes the payment and charges the customer.

    • The Klarna app for VTEX only supports full capture or one partial capture, multiple partial captures are not currently supported.
  • Refund:

    • Issues a refund for an order.

    • VTEX only refunds the value of the products. To refund tax, shipping, or additional charges, these must be specified as an additional amount in the refund request.
  • Cancel:

    • Cancels an order before it is captured.

    • If an order is authorized but not yet captured, cancellation releases the authorized funds back to the customer.
  • Release uncaptured amount:

    • If an order is modified (lower amount than the amount authorized) before capture, the Klarna Payments App automatically adjusts the captured amount to the new order total and releases any uncaptured funds.

VTEX order actions trigger specific status updates in Klarna. The table below outlines how these actions map between VTEX and Klarna:

Order action on VTEXWhat happens on Klarna
Return/RefundKlarna refunds the order.
Invoice/CaptureKlarna captures the full amount specified by VTEX. If less than the authorized amount, Klarna releases the remaining funds automatically.
CancelKlarna cancels the order.
Partially CapturedKlarna refunds the reminder of the order.
ExpiredNo action is possible.
ClosedNo action is possible.