Verify Withdrawal

Verify the status and details of a withdrawal transaction using its transaction reference.

Verify Withdrawal

GET https://api.cngn.co/v1/api/withdraw/verify/{tnxRef}

Returns the full details of a withdrawal transaction by its reference.

Path Parameters

Name	Type	Description
tnxRef*	string	The transaction reference returned from the withdrawal endpoint.

200 Transaction fetched successfully

{
  "status": 200,
  "message": "Transaction fetched successfully",
  "data": {
    "id": "clx1abc123def456",
    "from": "Convexity",
    "receiver": {
      "address": "0x5678901234abcdef5678901234abcdef56789012"
    },
    "amount": "10000.00",
    "description": "Withdrawal",
    "createdAt": "2025-06-15T10:30:00.000Z",
    "trx_ref": "WTH-20250615-ABC123",
    "trx_type": "withdraw",
    "network": "bsc",
    "asset_type": "cNGN",
    "asset_symbol": "CNGN",
    "base_trx_hash": "0xabc123def456789...",
    "extl_trx_hash": "0xdef456abc789012...",
    "explorer_link": "https://bscscan.com/tx/0xdef456abc789012...",
    "status": "completed"
  }
}

400 Invalid request

Response Fields (Decrypted)

Field	Type	Description
id	string	Unique transaction identifier
from	string	Sender identifier
receiver	object	Receiver wallet address
amount	string	Withdrawal amount
description	string	Transaction description
createdAt	string	ISO 8601 timestamp
trx_ref	string	Transaction reference
trx_type	string	Transaction type (withdraw)
network	string	Blockchain network (see Networks Enum)
asset_type	string	Asset type
asset_symbol	string	Asset symbol
base_trx_hash	string/null	Base transaction hash
extl_trx_hash	string/null	External blockchain transaction hash
explorer_link	string/null	Block explorer link for verification
status	string	Transaction status (pending, completed)

Example Request

curl -X GET https://api.cngn.co/v1/api/withdraw/verify/WTH-20250615-ABC123 \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY"