Refund Transaction
Request a refund for a failed send. The send must be at least one hour old. If an on-chain hash exists, the API verifies the send failed on-chain before queuing the refund.
Endpoint: POST /transaction/refund
Authentication: Required (x-api-key for live, x-staging-api-key for test)
Request Parameters
Parameter
Type
Required
Description
refid
integer
Yes
Reference ID of the send (token_send_queue.refid)
Example Request
curl -X POST https://service.roqqu.com/v1/transaction/refund \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "refid=10704380386654367514"Example Response (Success)
{
"status": "success",
"message": "token queued for refund successfully",
"data": null
}When the refund is processed, a
token_refundedwebhook may be emitted. See Coin Webhook Events.
Error Responses
Transaction does not exist:
Too early (under one hour):
Transaction did not fail on-chain:
No on-chain receipt:
Already refunded:
Missing refid:
Last updated