---
title: "Capture payment"
method: POST
path: "/orders/{order_id}/capture"
tags: ["Payments"]
---

# Capture payment

`POST /orders/{order_id}/capture`

Capture the full or a partial amount for a credit or debit card payment.

## Path parameters

- `order_id` string, required

## Request body

- object
  - `amount` integer, required — The payment amount in the currency's smallest unit: - Decimal currencies: Value for 10 EUR = 1000 (1000 cents) - Zero-decimal currencies: Value for 10 JPY = 10 **Full captures:** Specify the original amount. **Partial captures:** Specify the amount to capture.
  - `new_order_id` string — Your unique identifier for the captured order. Applies to partial captures only. If omitted, an ID is auto-generated.
  - `new_order_status` 'completed', required — The [order status](/https://docs.multisafepay.com/docs/payment-statuses/).
  - `invoice_id` string — Your unique identifier for the invoice, which appears in [reports](https://docs.multisafepay.com/docs/reports/).
  - `tracktrace_code` string — The track and trace code for the shipment (recommended).
  - `carrier` string — The name of the shipping company (recommended).
  - `reason` string — The reason for capturing the order.
  - `description` string — Any additional information.

## Response `200`

Request successful

- object
  - `success` Success — unresolved $ref
  - `data` object — Information about the capture order.
    - `transaction_id` Schema — unresolved $ref
    - `order_id` OrderId — unresolved $ref

## Other responses

- `404` — Error

---

[API](https://skmtc.dev/multisafepay/apis/multisafepay-banking-order-api.md) · [All operations](https://skmtc.dev/multisafepay/apis/multisafepay-banking-order-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/multisafepay/multisafepay-banking-order-api/revisions/ce9612e4a307/schema)
