Klarna Docs - Capture a payment transaction
API and SDKsSupport
Capture a payment transaction

Capture payment transactions efficiently with Klarna by choosing full or partial options while ensuring clear post-capture communication for a seamless customer experience.

​This operation should be performed when the transaction, whether physical goods or intangible goods, is ready to be fulfilled. It allows for capturing either the full or partial payment amount. During capture, for physical goods you can include the shipping details along with the line items to provide a better tracking experience to customers and to improve record-keeping.

Klarna supports a maximum of 200 captures on any given transaction.

The expected outcomes of a capture on all involved parties are outlined in the diagram below:

flowchart LR A(Partner) -->|Ships item| B([Customer]) A --> |Capture| C(Acquiring Partner) C --> |Capture| D(Klarna) D --> |Begins dunning process| B D --> |Settlement triggered| C

After a payment is captured and the physical goods are shipped, maintaining active communication with the customer is critical to enhance customer trust and support. Detailed shipping information is a central element of the post-purchase communication with the customer to enable:

Elevated  customer experience:

  • Detailed shipping information reassures customers that their order has been processed and is on its way.
  • Tracking_number and tracking_url allow customers to monitor their delivery status at any time either via Partner website, the carrier system or by viewing the tracking lifecycle in the Klarna app.

Security and accountability:

  • shipping_type_attributes  specify the additional requirements for the delivery, for example SIGNATURE_REQUIRED, IDENTIFICATION_REQUIRED. This enables customers to know about for instance if they need to be present to receive the delivery.
  • Knowing the shipping_carrier (e.g., “DHL”) helps customers identify the service responsible for their package, which can aid in troubleshooting any issues by reaching out to the corresponding support services. Additionally this information also enables Klarna to locate the tracking details.

Improved customer support:

  • When customers have immediate access to shipping details, it reduces the likelihood of them contacting customer support for updates.
  • Real-time access allows both customers and support teams to promptly address and resolve any delivery concerns.

Ensure that the total capture amount does not exceed the payment amount unless you have reauthorized your payment transaction to a higher payment amount.

For non-guaranteed transactions, capture must not be triggered until the funding_state has reached FUNDED. If a transaction is captured prior to transitioning to that state and funds are not able to be collected by Klarna, this may result in a chargeback. More details available in Non-guaranteed transactions.

When performing a full capture, the entire value of the payment transaction should only be captured when you are ready to fulfill all goods or services included in the order.

Consult the API reference for a complete description of the request body parameters.

A partial capture is used when the items in the transaction are provisioned in parts. In this case, you capture only the part of the payment amount corresponding to the items being provisioned at that time. Klarna supports a maximum of 200 partial captures on a given transaction. This process allows for multiple partial captures until the total payment amount is received.

Consult the API reference for a complete description of the request body parameters.

Klarna supports a maximum of 200 captures and 500 total operations on any given transaction. Exceeding this restriction will result in a 403 response.