Documentation

Fetch Transaction Status

Use this endpoint to check the status of a payout transaction.

Endpoint

GET /payout/status

Query Parameters

  • client_ref_id - Your unique transaction reference (OR)
  • txn_id - Ztake transaction ID

Request Example

GET /payout/status?client_ref_id=unique_txn_123

Response

{
  "status": "success",
  "data": {
    "txn_id": "ZTK123456789",
    "client_ref_id": "unique_txn_123",
    "status": "SUCCESS",
    "amount": 1000.00,
    "utr": "UTR123456789",
    "beneficiary_name": "David Peter",
    "beneficiary_account": "1234567890",
    "created_at": "2025-01-13T10:30:00Z",
    "completed_at": "2025-01-13T10:31:00Z"
  }
}

Transaction Status Values

  • PENDING - Transaction is being processed
  • SUCCESS - Transaction completed successfully
  • FAILED - Transaction failed
  • REVERSED - Transaction was reversed