Skip to main content
GET
Retrieve Refund

Autorisaties

Authorization
string
header
vereist

An Account API key, an App API key, an account access token, an account-scoped user token, or a user OAuth token. Prepend the key or token with Bearer, for example Bearer ***************************. See Auth & API keys for how to get each one.

Scopes

payment:basic:read

Headers

Api-Version-Date
string

Pins the request to a dated API version.

Voorbeeld:

"2026-11-17"

Padparameters

id
string
vereist

The refund to retrieve, prefixed rf_.

Respons

refund retrieved

account_id
string | null
vereist

The account that issued the refund, prefixed biz_.

Voorbeeld:

"biz_xxxxxxxxxxxxxx"

amount
object | null
vereist

The refunded amount as it settled, in the payment's settlement currency, so pages of refunds net against the payment's refunded_amount. Converted at the rate in force when the refund was issued, not the payment's original rate. Null only when no exchange rate is recorded for a legacy multi-currency payment.

created_at
string
vereist

When the refund was requested, as an ISO 8601 timestamp.

Voorbeeld:

"2026-01-01T12:00:00.000Z"

failure_message
string | null
vereist

A merchant-facing explanation of why the refund failed, in the request's language. Null unless the refund failed or was canceled.

Voorbeeld:

"The customer's card is expired or was canceled."

failure_reason
enum<string> | null
vereist

Why the refund failed, normalized across providers. Null unless the refund failed or was canceled.

Beschikbare opties:
bank_declined,
expired_or_canceled_card,
lost_or_stolen_card,
insufficient_funds,
charge_disputed,
not_refundable,
merchant_request,
unknown,
null
Voorbeeld:

"expired_or_canceled_card"

id
string
vereist

Refund ID, prefixed rf_.

Voorbeeld:

"rf_xxxxxxxxxxxxxx"

metadata
object | null
vereist

Your own key-value data attached when the refund was requested.

Voorbeeld:

null

original_amount
object
vereist

The refunded amount in the currency the processor moved.

payment_id
string
vereist

The payment this refund reverses, prefixed pay_.

Voorbeeld:

"pay_xxxxxxxxxxxxxx"

provider
string
vereist

The payment provider that processed the refund, such as paypal or coinbase.

Voorbeeld:

"stripe"

provider_created_at
string | null
vereist

When the provider created the refund, as an ISO 8601 timestamp.

Voorbeeld:

"2026-01-01T12:00:00.000Z"

reason
enum<string> | null
vereist

Why the refund was issued, when recorded.

Beschikbare opties:
duplicate,
fraudulent,
requested_by_customer,
expired_uncaptured_charge,
dispute_alert,
null
Voorbeeld:

"duplicate"

reference_status
enum<string> | null
vereist

Whether a banking-network tracking reference is available for this refund.

Beschikbare opties:
available,
pending,
unavailable,
null
Voorbeeld:

"available"

reference_type
enum<string> | null
vereist

The kind of tracking reference, such as an acquirer reference number.

Beschikbare opties:
acquirer_reference_number,
retrieval_reference_number,
system_trace_audit_number,
null
Voorbeeld:

"acquirer_reference_number"

reference_value
string | null
vereist

The tracking reference the buyer's bank can trace the refund by.

Voorbeeld:

null

status
enum<string>
vereist

Where the refund stands with the processor: pending, requires_action, succeeded, failed, or canceled.

Beschikbare opties:
pending,
requires_action,
succeeded,
failed,
canceled
Voorbeeld:

"failed"

updated_at
string
vereist

When the refund last changed, as an ISO 8601 timestamp.

Voorbeeld:

"2026-01-01T12:00:00.000Z"

visa_rdr
boolean
vereist

True when the card network initiated the refund through Rapid Dispute Resolution.

Voorbeeld:

false