Skip to main content
POST
/
v1
/
transfer-requests
/
{id}
/
cancel
Cancel a transfer request
curl --request POST \
  --url https://api.railsfromthecrypt.com/v1/transfer-requests/{id}/cancel \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "reason": "User requested cancellation"
}
'
{
  "success": true,
  "message": "Transfer cancelled successfully",
  "data": {
    "id": "c17d2777-e604-45e2-b6d5-7743652eadf1",
    "type": "onramp",
    "status": "fetching_rates",
    "source": {
      "amount": 10000,
      "currency": "NGN"
    },
    "destination": {
      "amount": 0,
      "currency": "USDC"
    },
    "events": [
      {
        "status": "pending",
        "timestamp": "2023-11-07T05:31:56Z",
        "completed_at": "2023-11-07T05:31:56Z"
      }
    ],
    "payments": [],
    "created_at": "2025-10-10T09:15:21Z",
    "reference": "TXN-2Z82FVYO6BW22RC7",
    "rate": {
      "value": 0,
      "expires_at": null
    },
    "recipient": {
      "id": "rec_01J8V9ZP3A7",
      "type": "crypto",
      "name": "My USDT Wallet",
      "details": {
        "network": "Polygon",
        "wallet_address": "0xABC123DEF456...",
        "symbol": "USDT"
      }
    },
    "payment_instructions": {
      "type": "bank_transfer",
      "bank_transfer": {
        "account_number": "1234567890",
        "account_name": "HashRails Ltd",
        "bank_name": "Wema Bank",
        "bank_code": "035"
      }
    }
  }
}
Cancel an active transfer request. A cancellation reason must be provided.
Once cancelled, a transfer request cannot be resumed. You will need to create a new transfer request to retry.

Headers

​
x-api-key
string
required

API key for authentication

Path Parameters

​
id
string
required

Unique transfer request ID

Example:

"c17d2777-e604-45e2-b6d5-7743652eadf1"

Body

application/json
​
reason
string
required

Reason for cancellation

Example:

"User requested cancellation"

Response

Transfer cancelled successfully

​
success
boolean
Example:

true

​
message
string
Example:

"Transfer cancelled successfully"

​
data
object