Skip to content
For the complete documentation index, see llms.txt. This page is also available as Markdown.

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_refunded webhook 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