Capture a Payment Transaction
Capture authorized funds, fully or partially, when fulfilling goods or services. Choose the capture mode that matches the fulfillment model and include shipping details to improve the post-purchase experience.
4 min read
Call capturePaymentTransaction
when the transaction is ready to be fulfilled, whether for physical goods or intangible goods. Partners can capture either the full or a partial amount of the authorized Payment Transaction. For physical goods, include shipping details and line items in the capture request to provide a better tracking experience to customers and to improve record-keeping.
when the transaction is ready to be fulfilled, whether for physical goods or intangible goods. Partners can capture either the full or a partial amount of the authorized Payment Transaction. For physical goods, include shipping details and line items in the capture request to provide a better tracking experience to customers and to improve record-keeping.The expected outcomes of a capture are outlined in the diagram below:
flowchart LR
A(Partner) -->|Ships item| B([Customer])
A --> |Capture| D(Klarna)
D --> |Begins dunning process| B
D --> |Settlement triggered| A
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, and enables:
Elevated customer experience:
- Detailed shipping information reassures customers that their purchase has been processed and is on its way.
tracking_numberandtracking_urlallow customers to monitor their delivery status at any time, via the Partner's website, the carrier system, or by viewing the tracking lifecycle in the Klarna app.- Send additional data points when capturing transactions by using
klarna_network_datato ensure consistent customer and transaction context throughout the payment flow.
Security and accountability:
shipping_type_attributesspecify additional requirements for the delivery, for exampleSIGNATURE_REQUIREDorIDENTIFICATION_REQUIRED. This lets customers know 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 resolving any issues by reaching out to the corresponding support services. It 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 the Payment Transaction has been reauthorized to a higher amount.
Integration requirement
For non-guaranteed transactions, capture must not be triggered until
funding_state reaches FUNDED. If a Payment Transaction is captured before transitioning to that state and Klarna cannot collect the funds, this may result in a chargeback. More details are available in Read and update a Payment Transaction.When performing a full capture, the entire value of the Payment Transaction is captured in a single call. Use it only when ready to fulfill all goods or services included in the Payment Transaction.
A partial capture is used when the items in the transaction are provisioned in parts. In this case, only the portion of the payment amount corresponding to the items being provisioned at that time is captured. This process allows for multiple partial captures until the total payment amount is received.
Integration requirement
Klarna supports a maximum of 200 captures and 500 total actions on any given Payment Transaction. Exceeding this restriction will result in a
403 response.Final capture automatically releases any remaining authorization in conjunction with the first capture, making it a final capture unless explicitly set to be partial. There are two main options for the
remaining_authorization parameter:| Option | Description |
|---|---|
KEEP | The remaining authorization after the initial capture is retained, making it available for future captures or actions. To retain authorization for future use, set remaining_authorization to KEEP. |
RELEASE (default) | The remaining authorization is fully released once the current capture is completed. |
Over capture simplifies integration by merging the reauthorization and capture steps into a single endpoint call. It uses the same capturePaymentTransaction action, but accepts a higher amount than the original authorization.
action, but accepts a higher amount than the original authorization.This enables more flexible transaction handling: Partners can reauthorize and capture a greater amount than initially anticipated, all within one step. For example, this is especially useful if a customer's shipping address changes at the last minute and impacts the transaction amount due to varying state taxes.
Credit risk assessment
This capability is subject to a thorough credit risk assessment.
For the full request and response specifications across all capture modes, refer to the capturePaymentTransaction API reference.
API reference.Related articles
Jump to section...