---
title: "Check whether a refund's payout details can be resolved for a transaction (read-only)"
method: GET
path: "/api/v1/merchants/{merchantId}/transactions/{transactionId}/refund-readiness"
tags: ["Transactions"]
---

# Check whether a refund's payout details can be resolved for a transaction (read-only)

`GET /api/v1/merchants/{merchantId}/transactions/{transactionId}/refund-readiness`

Check whether a refund's payout details can be resolved for a transaction (read-only)

## Path parameters

- `merchantId` string, uuid, required — The unique identifier of the merchant
- `transactionId` string, uuid, required — The unique identifier of the original transaction

## Response `200`

Success

- CrossBorderRefundRefundReadinessResponse
  - `success` boolean, required
  - `data` object, required
    - `resolvable` boolean, required — True when the refund payout details resolve with no outstanding problems
    - `problems` object[], required — Outstanding problems preventing the refund; empty when resolvable
      - `code` string, required — Error code identifying the problem
      - `message` string, required — Human-readable description of the problem
      - `label` string, required — Display label for the problem
      - `is_resolvable` boolean, required — Whether the problem can be resolved by providing additional data
    - `payout` object, nullable, required — Resolved payout details, or null when bank details could not be resolved
      - `currency` string, required — Resolved payout currency (ISO 4217)
      - `country` string, required — Resolved payout country (ISO 3166-1 alpha-2)
      - `account_masked` string, required — Masked customer account identifier (last 4 shown)
      - `bic_resolved` boolean, required — Whether a BIC/SWIFT code was resolved for the payout account

## Other responses

- `401` — Unauthorized
- `404` — Not Found

---

[API](https://skmtc.net/banqzinc/apis/quidkey-api.md) · [All operations](https://skmtc.net/banqzinc/apis/quidkey-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/banqzinc/quidkey-api/revisions/f86d2bdbcb08/schema)