Skip to main content
GET
List payment refunds
Returns the refunds belonging to one Payment in reverse chronological order. Page with limit (up to 100, default 20) and cursor.

Authorizations

Authorization
string
header
required

HTTP Basic auth. Username is the Stableyard app ID. Password is the app secret. The optional Stableyard-Version request header must match the environment pin.

Headers

Stableyard-Version
enum<string>

Optional contract-version assertion. Omit it to use the app environment's pinned version. A different supported version is accepted only after that environment is explicitly migrated.

Available options:
2026-09-09

Path Parameters

paymentId
string
required

Canonical payment_* identifier. Internal execution identifiers are never accepted by Partner Payment routes.

Pattern: ^payment_[A-Za-z0-9_-]+$
Example:

"payment_123"

Query Parameters

limit
integer
default:20
Required range: 1 <= x <= 100
cursor
string

Opaque cursor returned as nextCursor by the previous page.

Response

Payment refunds

refunds
object[]
required
nextCursor
string | null
required