Capture payin

post

https://api.sandbox.rainforestpay.com/v1/payins/{payin_id}/capture

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

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

payin_id

string

required

The unique payin identifier.

Prefix is "pyi" in production and "sbx_pyi" in sandbox.

Body Params

amount

integer

≥ 1

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

array of objects

length between 0 and 26

Update the amount split, which represents how the payin should be split between the originating merchant, the platform, and one or more other merchants. If omitted, the amount split defined on the payin config will be used.

amount_splits

metadata

object

Update the metadata. If metadata is already set on the payin_config, both metadata objects will be merged together. If omitted, the metadata defined on the payin_config will be used.

Headers

Rainforest-Api-Version

string

enum

Defaults to 2024-10-16

Allowed:

Responses

200OK

400Bad request, check for validation errors.

401Authorization missing or invalid.

403Authorization insufficient for requested action.

404Resource not found.

5XXUnexpected error.