> For the complete documentation index, see [llms.txt](https://pivot-payment.gitbook.io/pivot-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://pivot-payment.gitbook.io/pivot-docs/api-references/api-lists/payments/capture.md).

# Capture

## Method and URL

<mark style="color:green;">`POST`</mark> \[<mark style="color:orange;">BASE\_URL</mark>]/v2/payments/{id}/capture

<mark style="color:orange;">`id`</mark> from the Payment Session ID whenever you create Payment Session

## Request

**Request Body**

```json
{
  "releaseRemainingAmount": true,
  "amount": {
    "currency": "IDR",
    "value": 12000
  }
}
```

**Detail Parameter Request**

<table><thead><tr><th width="217.60546875">Parameter</th><th width="119.98828125">Data Type</th><th width="137.298828125">Requirement</th><th>Description</th></tr></thead><tbody><tr><td>releaseRemainingAmount</td><td>Object</td><td>M</td><td>Choose either <mark style="color:orange;"><code>true</code></mark> or <mark style="color:orange;"><code>false</code></mark>, to  void the remaining authorized amount</td></tr><tr><td>amount</td><td>Object</td><td>C</td><td><a data-mention href="/pages/Foeq3eyfnM9O2anL1Vby">/pages/Foeq3eyfnM9O2anL1Vby</a></td></tr></tbody></table>

## Response

**Response Body**

```json
{
  "code": "00",
  "message": "Success",
  "data": {
    "id": "019c0d24-ec94-74b5-a4b7-b4da305bc41a",
    "paymentSessionId": "e03c2066-9e5b-454c-add6-c7c85b0b9d6b",
    "paymentSessionClientReferenceId": "1769746960",
    "releaseRemainingAmount": true,
    "amount": {
      "value": 12000,
      "currency": "IDR"
    },
    "status": "PENDING",
    "createdAt": "2026-01-30T04:24:09.620309094Z",
    "updatedAt": "2026-01-30T04:24:09.620309237Z"
  }
}
```

**Detail Parameter Response**&#x20;

<table><thead><tr><th width="197.9619140625">Parameter</th><th width="114.29296875">Data Type</th><th width="138.7783203125">Requirement</th><th>Description</th></tr></thead><tbody><tr><td>id</td><td>String</td><td>M</td><td>Unique Capture ID</td></tr><tr><td>paymentSessionId</td><td>String</td><td>M</td><td>Payments Session Id</td></tr><tr><td>PaymentSessionClientReferenceId</td><td>Alphanumeric</td><td>M</td><td>Payment Session merchant reference Id</td></tr><tr><td>amount</td><td>Object</td><td>M</td><td><a data-mention href="/pages/Foeq3eyfnM9O2anL1Vby">/pages/Foeq3eyfnM9O2anL1Vby</a></td></tr><tr><td>status</td><td>String</td><td>M</td><td>Status of Capture:<br>1. PENDING<br>2. SUCCESS<br>3. FAILED</td></tr><tr><td>createdAt</td><td>String</td><td>Auto generated</td><td>Created time with format YYYY-MM-DDTHH:MM:SSZ</td></tr><tr><td>updatedAt</td><td>String</td><td>Auto generated</td><td>Updated time with format YYYY-MM-DDTHH:MM:SSZ</td></tr></tbody></table>