Retrieve Unreferenced Refund by ID

GET

unreferenced-refunds

{unreferenced_refund_id}

curl --request GET \
  --url 'https://api.y.uno/v1/unreferenced-refunds/d290f1ee-6c54-4b01-90e6-d701748f0851?include_raw_responses=true' \
  --header 'public-api-key: YOUR_PUBLIC_API_KEY' \
  --header 'private-secret-key: YOUR_PRIVATE_SECRET_KEY' \
  --header 'Accept: application/json'

{
  "id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
  "account_id": "9f6e0a4c-1d2b-4e3f-8a9b-1c2d3e4f5a6b",
  "merchant_order_id": "REFUND-2026-05-14-001",
  "country": "US",
  "amount": { "value": 25.00, "currency": "USD" },
  "status": "SUCCEEDED",
  "sub_status": "SUCCEEDED",
  "payment_method": {
    "vaulted_token": "550e8400-e29b-41d4-a716-446655440000",
    "detail": {
      "card": {
        "card_data": { "brand": "VISA", "last_four": "1111", "type": "CREDIT" }
      }
    }
  },
  "customer_payer": {
    "id": "6ba7b810-9dad-11d1-80b4-00c04fd430c8"
  },
  "provider": {
    "name": "STRIPE",
    "type": "PSP",
    "reference": "re_3OqQz92eZvKYlo2C0g6XK1Yj",
    "category": "APPROVED",
    "raw_response_code": "succeeded",
    "raw_response_message": "Refund settled",
    "raw_request": {
      "amount": 2500,
      "currency": "usd",
      "payment_method": "pm_1OqQz92eZvKYlo2C7Kx9Vbnm",
      "metadata": { "merchant_order_id": "REFUND-2026-05-14-001" }
    },
    "raw_response": {
      "id": "re_3OqQz92eZvKYlo2C0g6XK1Yj",
      "object": "refund",
      "amount": 2500,
      "currency": "usd",
      "status": "succeeded"
    }
  },
  "created_at": "2026-05-14T11:47:13.482Z",
  "updated_at": "2026-05-14T11:47:18.030Z"
}

{
  "code": "UNREFERENCED_REFUND_NOT_FOUND",
  "messages": [
    "No unreferenced refund with the provided id exists on this account."
  ]
}

This request enables you to retrieve details of an unreferenced refund based on its id, which needs to be provided in the request path.

Provider raw dataThe provider object carries the untouched provider exchange in two fields. The shape of both is defined by the provider, not by Yuno, so it varies per provider and per operation. Each is controlled separately:

Field	Content	How to obtain it
`raw_request`	The exact payload Yuno sent to the provider.	Requires your account to be enabled for provider raw data. Contact your Yuno account manager to request access. Not affected by `include_raw_responses`.
`raw_response`	The full payload the provider returned.	Pass `include_raw_responses=true` on this request.

raw_response_code and raw_response_message are summaries of the provider’s answer and are always returned, independently of both preceding fields.

string

required

The unique public API key for your account.

string

required

The unique private secret key for your account.

string

required

Yuno-generated unique identifier of the unreferenced refund.

boolean

default:"false"

When true, the provider object in the response payload will include raw_response, the full payload the provider returned. The raw_response_code and raw_response_message summary fields are always returned, regardless of this parameter.

boolean

default:"false"

When true, returns the full list of attempts and intermediate network responses if the refund triggered multiple internal retries.

curl --request GET \
  --url 'https://api.y.uno/v1/unreferenced-refunds/d290f1ee-6c54-4b01-90e6-d701748f0851?include_raw_responses=true' \
  --header 'public-api-key: YOUR_PUBLIC_API_KEY' \
  --header 'private-secret-key: YOUR_PRIVATE_SECRET_KEY' \
  --header 'Accept: application/json'

{
  "id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
  "account_id": "9f6e0a4c-1d2b-4e3f-8a9b-1c2d3e4f5a6b",
  "merchant_order_id": "REFUND-2026-05-14-001",
  "country": "US",
  "amount": { "value": 25.00, "currency": "USD" },
  "status": "SUCCEEDED",
  "sub_status": "SUCCEEDED",
  "payment_method": {
    "vaulted_token": "550e8400-e29b-41d4-a716-446655440000",
    "detail": {
      "card": {
        "card_data": { "brand": "VISA", "last_four": "1111", "type": "CREDIT" }
      }
    }
  },
  "customer_payer": {
    "id": "6ba7b810-9dad-11d1-80b4-00c04fd430c8"
  },
  "provider": {
    "name": "STRIPE",
    "type": "PSP",
    "reference": "re_3OqQz92eZvKYlo2C0g6XK1Yj",
    "category": "APPROVED",
    "raw_response_code": "succeeded",
    "raw_response_message": "Refund settled",
    "raw_request": {
      "amount": 2500,
      "currency": "usd",
      "payment_method": "pm_1OqQz92eZvKYlo2C7Kx9Vbnm",
      "metadata": { "merchant_order_id": "REFUND-2026-05-14-001" }
    },
    "raw_response": {
      "id": "re_3OqQz92eZvKYlo2C0g6XK1Yj",
      "object": "refund",
      "amount": 2500,
      "currency": "usd",
      "status": "succeeded"
    }
  },
  "created_at": "2026-05-14T11:47:13.482Z",
  "updated_at": "2026-05-14T11:47:18.030Z"
}

{
  "code": "UNREFERENCED_REFUND_NOT_FOUND",
  "messages": [
    "No unreferenced refund with the provided id exists on this account."
  ]
}

curl --request GET \
  --url 'https://api.y.uno/v1/unreferenced-refunds/d290f1ee-6c54-4b01-90e6-d701748f0851?include_raw_responses=true' \
  --header 'public-api-key: YOUR_PUBLIC_API_KEY' \
  --header 'private-secret-key: YOUR_PRIVATE_SECRET_KEY' \
  --header 'Accept: application/json'

{
  "id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
  "account_id": "9f6e0a4c-1d2b-4e3f-8a9b-1c2d3e4f5a6b",
  "merchant_order_id": "REFUND-2026-05-14-001",
  "country": "US",
  "amount": { "value": 25.00, "currency": "USD" },
  "status": "SUCCEEDED",
  "sub_status": "SUCCEEDED",
  "payment_method": {
    "vaulted_token": "550e8400-e29b-41d4-a716-446655440000",
    "detail": {
      "card": {
        "card_data": { "brand": "VISA", "last_four": "1111", "type": "CREDIT" }
      }
    }
  },
  "customer_payer": {
    "id": "6ba7b810-9dad-11d1-80b4-00c04fd430c8"
  },
  "provider": {
    "name": "STRIPE",
    "type": "PSP",
    "reference": "re_3OqQz92eZvKYlo2C0g6XK1Yj",
    "category": "APPROVED",
    "raw_response_code": "succeeded",
    "raw_response_message": "Refund settled",
    "raw_request": {
      "amount": 2500,
      "currency": "usd",
      "payment_method": "pm_1OqQz92eZvKYlo2C7Kx9Vbnm",
      "metadata": { "merchant_order_id": "REFUND-2026-05-14-001" }
    },
    "raw_response": {
      "id": "re_3OqQz92eZvKYlo2C0g6XK1Yj",
      "object": "refund",
      "amount": 2500,
      "currency": "usd",
      "status": "succeeded"
    }
  },
  "created_at": "2026-05-14T11:47:13.482Z",
  "updated_at": "2026-05-14T11:47:18.030Z"
}

{
  "code": "UNREFERENCED_REFUND_NOT_FOUND",
  "messages": [
    "No unreferenced refund with the provided id exists on this account."
  ]
}

Getting Started

Reference

Customers

Network Tokens

Customer Sessions (Enrollment)

Checkout Sessions

Payment Methods (Checkout)

Checkout Builder

Payment Methods (Direct Workflow)

PCI Proxy

Payments

Pre-Debit Notifications

3DS2 Setup

Unreferenced Refunds

Dry-run

Transaction Reporting

Routing Recommendations

Payment Links

Recipients for Marketplace

Sellers (Franchise)

Subscriptions Plans

Subscriptions

Payouts

Organizations

Reports

Installments

AI Caller

Communications Campaigns

Conversion Rate

Banking Connectivity

Webhooks