Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.dintero.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Capturing

When you are ready to ship the order, the transaction can be captured. When capturing, the money will be transferred to the merchant’s account.
After authorizing the transaction, it needs to be captured within a certain amount of time. See https://www.dintero.com/knowledge-base/authorizations for more details.
The API allows for both a full amount capture and a partial amount capture. The amount to capture cannot be higher than the authorized amount. Partial capture can be used to capture parts of the total transaction amount when needed, e.g, if only parts of the entire order is shipped or for other reasons. Partial capture may be called as many times as required as long as there is a remaining authorized amount to capture.
If the session contained an order.shipping_option, this will have been moved to the list of items in the transaction, and this is where you should specify the shipping_option when capturing.
NB! Captures might fail for various reasons, so it’s important to check that the response indicates a successful capture.

​
Request

POST /v1/transactions/{id}/capture Capture 
{
  "amount": 29990,
  "capture_reference": "string",
  "items": [
    {
      "line_id": "1",
      "amount": 29990
    }
  ]
}
According to regulations you should not capture a payment until the product or service is provided to the customer. For more information, please see the Consumer Authority’s Guidelines for the standard sales conditions for consumer purchases of goods over the internet.

​
Updating authorization

For transactions authorized with Klarna (klarna.klarna) or Billie (klarna.billie), it is possible to update the authorized amount after the initial authorization. This allows merchants to add items to an order before capture — for example, to upsell additional products.
Updating the authorization is only supported for Klarna and Billie transactions that have not yet been fully captured.

​
Request

POST /v1/transactions/{id}/authorization Update authorization 
{
  "amount": 35990,
  "items": [
    {
      "line_id": "1",
      "description": "Product A",
      "quantity": 1,
      "amount": 29990,
      "vat_amount": 5998,
      "vat": 25
    },
    {
      "line_id": "2",
      "description": "Extra item",
      "quantity": 1,
      "amount": 6000,
      "vat_amount": 1200,
      "vat": 25
    }
  ]
}
The amount field is the new total authorized amount. If the transaction already has items, the items field is required and must include the updated list of items, and the sum of items[*].amount must equal the new amount. For transactions without existing items, items is optional; when provided, the same sum rule applies.

​
Backoffice

To add items to an authorized Klarna or Billie transaction via Backoffice:
  1. Navigate to the transaction (status must be Authorized)
  2. In the Order items section, click + Add item
  3. Fill in the item details: description, quantity, unit price, and VAT %
  4. Click Update
The authorized amount is automatically updated to reflect the new total.

​
Void/cancel

If, for some reason, the order will not be fulfilled, you can cancel the transaction to release the money from the customer’s account. A transaction can only be voided if it has not been captured. After the void is successful, the transaction status is changed to AUTHORIZATION_VOIDED

​
Request

POST /v1/transactions/{id}/void Void

​
Response

{
  "id": "...",
  ...
  "status": "AUTHORIZATION_VOIDED"
}

​
Refund

If the order, or parts of it, are returned, the money can be refunded. The refund amount cannot be larger than the captured amount.
NB! Refunds might fail for various reasons, so it’s important to check that the response indicates a successful refund.

​
Request

POST /v1/transactions/{id}/refund Refund 
{
  "amount": 29990,
  "reason": "string",
  "items": [
    {
      "line_id": "1",
      "amount": 29990
  }]
}
Last modified on May 13, 2026