---
title: "Capture payin"
method: POST
path: "/v1/payins/{payin_id}/capture"
tags: ["Payins"]
---

# Capture payin

`POST /v1/payins/{payin_id}/capture`

Capture an authorized payin. The payin status must be Authorized to capture.

## Parameters

- `#/paths/~1v1~1payins/get/parameters/0` — unresolved $ref
- `#/paths/~1v1~1payins~1%7Bpayin_id%7D/get/parameters/1` — unresolved $ref

## Request body

- object
  - `amount` integer — The amount to capture, in minor units. Must be less than or equal to the amount authorized. If omitted or set to 0, the full authorized amount will be captured.
  - `amount_splits` AmountSplits — unresolved $ref
  - `metadata` Schema — unresolved $ref

## Response `200`

OK

- object
  - `status` Status — unresolved $ref
  - `data` Data — unresolved $ref
  - `errors` Errors — unresolved $ref

## Other responses

- `400` — unresolved $ref
- `401` — unresolved $ref
- `403` — unresolved $ref
- `404` — unresolved $ref
- `5XX` — unresolved $ref

---

[API](https://skmtc.dev/rainforestpay/apis/authentication.md) · [All operations](https://skmtc.dev/rainforestpay/apis/authentication/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/rainforestpay/authentication/revisions/529a0dab0f90/schema)