# Capture an order

Create capture. Read more on Capturing an order

Endpoint: POST /ordermanagement/v1/orders/{order_id}/captures
Version: 1.0.0

## Path parameters:

  - `order_id` (string, required)
    Order id

## Header parameters:

  - `Klarna-Idempotency-Key` (string)
    This header will guarantee the idempotency of the operation. The key should be unique and is recommended to be a UUID version 4. Retries of requests are safe to be applied in case of errors such as network errors, socket errors and timeouts. Input values of the operation are disregarded when evaluating the idempotency of the operation, only the key matters.

## Request fields (application/json):

  - `captured_amount` (integer, required)
    The captured amount in minor units.

  - `description` (string)
    Description of the capture shown to the customer. Maximum 255 characters.

  - `order_lines` (array)
    Order lines for this capture. Maximum 1000 items.

  - `order_lines.image_url` (string)
    URL to an image that can be embedded in communications between Klarna and the customer.
    Example: "https://yourstore.example/product/headphones.png"

  - `order_lines.merchant_data` (string)
    Data about the order line.
    Example: "Some metadata"

  - `order_lines.name` (string, required)
    Descriptive item name.

  - `order_lines.product_identifiers` (object)
    product_identifiers

  - `order_lines.product_identifiers.brand` (string)
    The product's brand name as generally recognized by consumers. If no brand is available for a product, do not supply any value. Maximum 70 characters. Example: Intel
    Example: "Intel"

  - `order_lines.product_identifiers.category_path` (string)
    The product's category path as used in the merchant's webshop. Include the full and most detailed category and separate the segments with ' > '. Maximum 750 characters. Example: Electronics Store > Computers & Tablets > Desktops
    Example: "Electronics Store > Computers & Tablets > Desktops"

  - `order_lines.product_identifiers.color` (string)
    Color to be shown to the end customer (max 64 characters). Example: Denim blue
    Example: "Denim blue"

  - `order_lines.product_identifiers.global_trade_item_number` (string)
    The product's Global Trade Item Number (GTIN). Common types of GTIN are EAN, ISBN or UPC. Exclude dashes and spaces, where possible. Maximum 50 characters. Example: 735858293167
    Example: 735858293167

  - `order_lines.product_identifiers.manufacturer_part_number` (string)
    The product's Manufacturer Part Number (MPN), which - together with the brand - uniquely identifies a product. Only submit MPNs assigned by a manufacturer and use the most specific MPN possible. Maximum 70 characters. Example: BOXNUC5CPYH
    Example: "BOXNUC5CPYH"

  - `order_lines.product_identifiers.size` (string)
    Size to be shown to the end customer (max 64 characters). Example: 4
    Example: 4

  - `order_lines.product_url` (string)
    URL to the product that can be used in communications between Klarna and the customer.
    Example: "https://yourstore.example/product/headphones"

  - `order_lines.quantity` (integer, required)
    Item quantity.
    Example: 1

  - `order_lines.quantity_unit` (string)
    Unit used to describe the quantity.
    Example: "pcs."

  - `order_lines.reference` (string)
    Article number, SKU, or similar identifier on the product variant level.
    Example: 75001

  - `order_lines.tax_rate` (integer)
    The tax rate in percent with two implicit decimals.

  - `order_lines.total_amount` (integer, required)
    Total amount including tax and discounts (quantity * unit_price - total_discount_amount).

  - `order_lines.total_discount_amount` (integer)
    The discount amount in minor units. Includes tax. Example: 1200 = $12. Max value: 200000000

  - `order_lines.total_tax_amount` (integer)
    The total tax amount in minor units.

  - `order_lines.type` (string)
    Order line type.
    Enum: "physical", "discount", "shipping_fee", "sales_tax", "store_credit", "gift_card", "digital", "surcharge", "return_fee", "package"

  - `order_lines.unit_price` (integer, required)
    Unit price including tax without applying discounts in minor units.

  - `reference` (string)
    Internal reference to the capture. This will be included in the settlement files. Max length is 255 characters.

  - `shipping_delay` (integer)
    Delay before the order will be shipped. Use for improving the customer experience regarding payments. This field is currently not returned when reading the order. Minimum: 0. Please note: to be able to submit values larger than 0, this has to be enabled in your merchant account. Please contact Kustom for further information.

  - `shipping_info` (array)
    Shipping information for this capture. Maximum 500 items.

  - `shipping_info.return_shipping_company` (string)
    Name of the shipping company for the return shipment (as specific as possible). Maximum 100 characters. Example: 'DHL SE' and not only 'DHL'
    Example: "DHL SE"

  - `shipping_info.return_tracking_number` (string)
    Tracking number for the return shipment. Maximum 100 characters.
    Example: 93456415674545680000

  - `shipping_info.return_tracking_uri` (string)
    URL where the customer can track the return shipment. Maximum 1024 characters.
    Example: "http://shipping.example/findmypackage?93456415674545679888"

  - `shipping_info.shipping_company` (string)
    Name of the shipping company (as specific as possible). Maximum 100 characters. Example: 'DHL SE' and not only 'DHL'
    Example: "DHL SE"

  - `shipping_info.shipping_method` (string)
    Shipping method. Allowed values matches (PickUpStore|Home|BoxReg|BoxUnreg|PickUpPoint|Own|Postal|DHLPackstation|Digital|Undefined|PickUpWarehouse|ClickCollect|PalletDelivery)
    Example: "Home"

  - `shipping_info.tracking_number` (string)
    Tracking number for the shipment. Maximum 100 characters.
    Example: 63456415674545680000

  - `shipping_info.tracking_uri` (string)
    URI where the customer can track their shipment. Maximum 1024 characters.
    Example: "http://shipping.example/findmypackage?63456415674545679874"

## Response 403 fields (application/json):

  - `correlation_id` (string)
    Correlation id. For searching logs.
    Example: "66782175-ae05-44fc-9eb3-eeceadbad271"

  - `error_code` (string)
    Error code
    Example: "CAPTURE_NOT_ALLOWED"

  - `error_messages` (array)
    Error messages

## Response 404 fields (application/json):

  - `correlation_id` (string)
    Correlation id. For searching logs.
    Example: "66782175-ae05-44fc-9eb3-eeceadbad271"

  - `error_code` (string)
    Error code
    Example: "NO_SUCH_ORDER"

  - `error_messages` (array)
    Error messages


## Response 201 fields