Verify Payout/Withdrawal

The withdrawal process for cash to bank.

GET /verify-payout

This endpoint verifies the status of a payout (i.e., a bank transfer) associated with a previously initiated withdrawal. It accepts the transaction reference, tx_ref, and returns a sanitized response with key information

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <api_key>

Body

Name	Type	Description
tx_ref	string	The transaction reference used to identify the payout record.

Example

Mint Allocation Check

{
  "pvRef": "PV-E8823747",
  "txHash": "0x2234a21626a407ae1a065dde7331a361114139c88077978811089f40f7323f90"
}

Response (200) Ok

Common Error Responses

Missing Fields:

{
  "status": 400,
  "error": "Invalid Request",
  "message": "Both pvRef and txHash are required"
}

Transaction Record Not Found:

Invalid Asset Type (non‑ENSC):

Invalid Transaction Hash:

Transaction Failed On-chain:

Bank Transfer Failure: