Get refund details

GET
/refunds/{id}

Fetch particular refund details, including its current status, refunded amount and on-chain transaction (once known).

Authorization

Bearer
headerAuthorizationBearer <JWT>

OAuth access token.

Path Parameters

id*string

Identifier of the refund.

Formatuuid

Header Parameters

X-Volt-Api-Version*1

Version of the API used. Currently, version 1 is the only version.

Value in1

Response Body

OK - Successful request, returning given refund's details.

application/json
  1. response
id*string

Identifier of the refund.

Formatuuid
paymentId*string

Identifier of the refunded payment.

Formatuuid
walletId*|

Identifier of the wallet the refund is paid from. This field is null for refunds initiated by the provider.

Formatuuid
status*RefundStatusEnum

Refund status.

Value in"PENDING""PROCESSING""COMPLETED""FAILED""CANCELLED"
reason*|

Reason for the refund.

targetWalletAddress*|

Address the refund is sent to.

amount*|

Fiat value of the refund as priced by the provider, in the currency of the original payment for refunds you request. It is not the stablecoin amount sent on-chain. This field is null until the provider has priced the refund.

transaction*|

On-chain evidence for the refund. This field is null until the on-chain transaction is known.

failureReason*|

This field is null unless status is FAILED.

createdAt*string

Date of refund creation.

Formatdate-time
updatedAt*|

Date of refund's last update.

Formatdate-time
Example Request
curl -X GET 'https://stablecoins.sandbox.volt.io/refunds/497f6eca-6276-4993-bfeb-53cbbbba6f08' \  -H 'X-Volt-Api-Version: 1'
Example Response
{  "id": "9d2c4b6a-8e1f-4a3b-9c7d-5e0f2a4b6c8d",  "paymentId": "3c1e8f2a-9b4d-4f7e-a6c5-2d8b1e0f9a7c",  "walletId": "6a4f0c9e-2d1b-4c8a-9f3e-b7d2a1c4e5f6",  "status": "COMPLETED",  "reason": "Order cancelled by the customer",  "targetWalletAddress": "0x71C7656EC7ab88b098defB751B7401B5f6d8976F",  "amount": {    "amount": "100.00",    "currency": "EUR"  },  "transaction": {    "hash": "0x4b8e2f1a7c3d5e9f0a1b2c3d4e5f60718293a4b5c6d7e8f90a1b2c3d4e5f6a7b"  },  "failureReason": null,  "createdAt": "2026-11-05T10:12:03+00:00",  "updatedAt": "2026-11-05T10:14:02+00:00"}