MVS Pay APIRefunds

List refunds

Lists refunds for the authenticated organization’s merchant via the payments engine. Refunds have no org-scoped sidecar, so this is a thin pass-through normalized to { refunds, total, limit, offset }. Use the optional payment_id query parameter to scope the results to a single payment.

Authentication

x-api-keystring

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

Query parameters

limitintegerOptionalDefaults to 50
Max rows to return.
offsetintegerOptionalDefaults to 0
Rows to skip.
payment_idstringOptional
Filter refunds to a single payment id.

Response

A page of refunds.
refundslist of objects
totalinteger
limitinteger
offsetinteger

Errors

401
Unauthorized Error
403
Forbidden Error
500
Internal Server Error
502
Bad Gateway Error