Withdraw

The withdrawal process for cash to bank.

POST /withdraw

Processes a withdrawal by verifying an on-chain redemption transaction and then initiating a bank transfer to the payout details previously sent along with the redeem request. It requires the generated transaction reference (pvRef) and the signed redeem transaction hash (txHash) from the blockchain.

Headers

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

Body

Name	Type	Description
pvRef	string	The transaction reference generated during redemption.
txHash	string	The signed transaction hash from the blockchain.

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: