Capture an authorization | MVS Developer Docs

Captures a manual-capture authorization, optionally for a partial amount_to_capture (cents). Pass an Idempotency-Key header to make the capture safe to retry.

Authentication

x-api-keystring

A scoped MvsPayApiKey, e.g. mvspay_live_…. Mint and scope keys from the dashboard (Settings → API Keys).

Path parameters

idstringRequired

The authorization (payment) id.

Request

This endpoint expects an object.

amount_to_captureintegerOptional

Positive integer (cents). Omit to capture the full authorized amount.

Response

The captured payment.

paymentobject

Hyperswitch payment_intent response. Loosely typed; extra Hyperswitch fields pass through.

Errors

400

Bad Request Error

401

Unauthorized Error

500

Internal Server Error

$	curl -X POST https://pay.mvscloud.com/api/authorizations/id/capture \
>	-H "x-api-key: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"amount_to_capture": 2000
>	}'

1	{
2	"payment": {
3	"payment_id": "string",
4	"status": "string",
5	"amount": 1,
6	"currency": "string",
7	"client_secret": "string",
8	"merchant_id": "string",
9	"connector": "string",
10	"metadata": {}
11	}
12	}