---
title: "Capture order"
method: POST
path: "/v2/payments/capture"
tags: ["Orders"]
---

# Capture order

`POST /v2/payments/capture`

Capture the payment associated with the order. The specified amount is deducted from the user's account and transferred to the merchant's account. You can capture an amount up to the total specified during order creation. You may also provide an updated `merchantReference` to update the order.

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `token` string, required — Order token.
  - `merchantReference` string — Merchant reference for tracking the order in your system.
  - `amount` Amount — The monetary amount.
    - `amount` string, required — Monetary value. Example: 187.95.
    - `currency` string, required — Currency code.

## Response `200`

Payment captured successfully

- object
  - `token` string, required — The order token.
  - `status` string, required — The status of the capture.
  - `totalAmount` object — The total amount captured.
    - `amount` string — The amount value.
    - `currency` string — The currency code (ISO 4217).
  - `orderDetails` object — The full order details.
  - `capturedAt` string — The date and time when the capture was processed.

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `409` — Conflict

---

[API](https://skmtc.net/scalapay/apis/scalapay-api.md) · [All operations](https://skmtc.net/scalapay/apis/scalapay-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/scalapay/scalapay-api/versions/c43238b80cb9/schema)