curl --request GET \
--url 'https://api.y.uno/v1/unreferenced-refunds/urf_01HX31R6QK7E2F4G5H6J7K8M9N?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": "urf_01HX31R6QK7E2F4G5H6J7K8M9N",
"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": "vt_01HX2Y3ZP4Q5R6S7T8U9V0W1X2",
"detail": {
"card": {
"card_data": { "brand": "VISA", "last_four": "1111", "type": "CREDIT" }
}
}
},
"customer_payer": {
"id": "cus_01HX2K9PQR3S4T5U6V7W8X9Y0Z"
},
"provider": {
"name": "STRIPE",
"type": "PSP",
"reference": "re_3OqQz92eZvKYlo2C0g6XK1Yj",
"category": "APPROVED",
"raw_response_code": "succeeded",
"raw_response_message": "Refund settled"
},
"created_at": "2026-05-14T11:47:13.482Z",
"updated_at": "2026-05-14T11:47:18.030Z"
}
{
"type": "https://docs.y.uno/errors/UNREFERENCED_REFUND_NOT_FOUND",
"code": "UNREFERENCED_REFUND_NOT_FOUND",
"title": "Unreferenced refund not found",
"status": 404,
"detail": "No unreferenced refund with id 'urf_01HX31R6QK7E2F4G5H6J7K8M9N' exists on this account.",
"trace_id": "01HX31R6QK7E2F4G5H6J7K8M9N"
}
Retrieve Unreferenced Refund by ID
Retrieve an existing unreferenced refund.
GET
/
v1
/
unreferenced-refunds
/
{unreferenced_refund_id}
curl --request GET \
--url 'https://api.y.uno/v1/unreferenced-refunds/urf_01HX31R6QK7E2F4G5H6J7K8M9N?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": "urf_01HX31R6QK7E2F4G5H6J7K8M9N",
"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": "vt_01HX2Y3ZP4Q5R6S7T8U9V0W1X2",
"detail": {
"card": {
"card_data": { "brand": "VISA", "last_four": "1111", "type": "CREDIT" }
}
}
},
"customer_payer": {
"id": "cus_01HX2K9PQR3S4T5U6V7W8X9Y0Z"
},
"provider": {
"name": "STRIPE",
"type": "PSP",
"reference": "re_3OqQz92eZvKYlo2C0g6XK1Yj",
"category": "APPROVED",
"raw_response_code": "succeeded",
"raw_response_message": "Refund settled"
},
"created_at": "2026-05-14T11:47:13.482Z",
"updated_at": "2026-05-14T11:47:18.030Z"
}
{
"type": "https://docs.y.uno/errors/UNREFERENCED_REFUND_NOT_FOUND",
"code": "UNREFERENCED_REFUND_NOT_FOUND",
"title": "Unreferenced refund not found",
"status": 404,
"detail": "No unreferenced refund with id 'urf_01HX31R6QK7E2F4G5H6J7K8M9N' exists on this account.",
"trace_id": "01HX31R6QK7E2F4G5H6J7K8M9N"
}
This request enables you to retrieve details of an unreferenced refund based on its
id, which needs to be provided in the request path.
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. Prefix
urf_.boolean
default:"false"
When
true, the provider object in the response payload will include raw_response_code and raw_response_message.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/urf_01HX31R6QK7E2F4G5H6J7K8M9N?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": "urf_01HX31R6QK7E2F4G5H6J7K8M9N",
"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": "vt_01HX2Y3ZP4Q5R6S7T8U9V0W1X2",
"detail": {
"card": {
"card_data": { "brand": "VISA", "last_four": "1111", "type": "CREDIT" }
}
}
},
"customer_payer": {
"id": "cus_01HX2K9PQR3S4T5U6V7W8X9Y0Z"
},
"provider": {
"name": "STRIPE",
"type": "PSP",
"reference": "re_3OqQz92eZvKYlo2C0g6XK1Yj",
"category": "APPROVED",
"raw_response_code": "succeeded",
"raw_response_message": "Refund settled"
},
"created_at": "2026-05-14T11:47:13.482Z",
"updated_at": "2026-05-14T11:47:18.030Z"
}
{
"type": "https://docs.y.uno/errors/UNREFERENCED_REFUND_NOT_FOUND",
"code": "UNREFERENCED_REFUND_NOT_FOUND",
"title": "Unreferenced refund not found",
"status": 404,
"detail": "No unreferenced refund with id 'urf_01HX31R6QK7E2F4G5H6J7K8M9N' exists on this account.",
"trace_id": "01HX31R6QK7E2F4G5H6J7K8M9N"
}
Was this page helpful?
⌘I