---
title: "Fetch Refund"
method: GET
path: "/v3/refund/{id}"
---

# Fetch Refund

`GET /v3/refund/{id}`

This endpoint fetches the details of an already existing refund object.

## Path parameters

- `id` string, required

## Response `200`

200

- object
  - `status` string — Indicates whether the refund creation request was successful.
  - `message` string — Describes the outcome of the refund operation.
  - `data` RefundData — Contains detailed information about a refund.
    - `id` string — Unique identifier for the refund object.
    - `object` string — Type of object returned, typically 'refund'.
    - `payin` string — Unique identifier of the payin linked to this refund.
    - `amount` integer — Refund amount in the smallest currency unit (e.g., cents).
    - `currency` string — Currency of the refund (ISO 4217 format).
    - `customer_receives` object — Amount and currency the customer will receive after processing the refund.
      - `currency` string — Currency in which the customer will receive the refund.
      - `amount` integer — Amount that the customer will receive after processing the refund.
    - `payment_attempt` string — Unique identifier of the payment attempt associated with this refund.
    - `reason` string — Reason provided for initiating the refund.
    - `metadata` Metadata, nullable — Custom metadata key-value pairs attached to the object
    - `status` string — Current status of the refund process (e.g., pending, processing, succeeded, failed).
    - `status_description` string — Detailed explanation of the current refund status.
    - `webhook_url` string — Webhook URL to which refund updates will be sent.
    - `created_at` string — Timestamp indicating when the refund was created (ISO 8601 format).
    - `balance_transaction` string — Balance transaction associated with the refund.
    - `reference_id` string — Reference id linked to the refund.
    - `holding_currency` string — Holding currency to which the refund is credited.

---

[API](https://skmtc.net/tazapay/apis/sandbox.md) · [All operations](https://skmtc.net/tazapay/apis/sandbox/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tazapay/sandbox/versions/bf5f4b8f6f5d/schema)