Get refund details
Fetch particular refund details, including its current status, refunded amount and on-chain transaction (once known).
BearerAuthorizationBearer <JWT>OAuth access token.
id*stringIdentifier of the refund.
uuidX-Volt-Api-Version*1Version of the API used. Currently, version 1 is the only version.
1OK - Successful request, returning given refund's details.
application/json- response
id*stringIdentifier of the refund.
uuidpaymentId*stringIdentifier of the refunded payment.
uuidwalletId*|Identifier of the wallet the refund is paid from. This field is null for refunds initiated by the provider.
uuidstatus*RefundStatusEnumRefund status.
"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*stringDate of refund creation.
date-timeupdatedAt*|Date of refund's last update.
date-timecurl -X GET 'https://stablecoins.sandbox.volt.io/refunds/497f6eca-6276-4993-bfeb-53cbbbba6f08' \ -H 'X-Volt-Api-Version: 1'{ "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"}Create refund POST
Refund a completed stablecoin payment in full, from one of your wallets to the payer's address. Partial refunds are not supported, so the request has no amount. The refund is processed asynchronously and `201` returns it in `PENDING`. Refunds have no webhook, so poll [Get refund details](#get-refund) until `status` is `COMPLETED`, `FAILED` or `CANCELLED`. A refund whose start or outcome at the provider cannot be confirmed stays in `PENDING` or `PROCESSING` until Volt has reviewed it, which can take a while. If a refund stays in `PENDING` or `PROCESSING`, contact Volt Technical Support at [support@volt.io](mailto:support@volt.io). A payment can have one refund in progress or completed. A new refund for the same payment is accepted only after the previous one has `FAILED` or is `CANCELLED`, and only once the provider confirms that the previous refund sent no funds. Otherwise the request returns `409`. Refunds that return a deposit received after the payment completed are listed too, but they do not count towards this rule. If the provider cannot be reached, the request returns `500` and no refund is created. Retry later with the same `Idempotency-Key`.
Get list of wallet transfers GET
Get list of wallet transfers. Transfers are returned oldest first.