Get a withdrawal

GET/api/merchant/withdrawals/{withdrawalId}

Get a withdrawal

Request

Parameters

Name	Location	Type	Required
withdrawalId	path	string	Yes

Responses

200 Withdrawal

Example response

{
  "message": "withdrawal fetched",
  "response": {
    "withdrawalId": "mwd_123e4567-e89b-12d3-a456-426614174000",
    "amount": 25000,
    "currency": "NGN",
    "status": "pending_otp",
    "destinationAccountNumber": "0123456789",
    "destinationBankCode": "100033",
    "destinationBankName": "PALMPAY",
    "destinationAccountName": "Jane Doe",
    "onchainTxHash": "",
    "providerTransferRef": "",
    "sessionId": "",
    "failureReason": "",
    "otpIssuedAt": "2026-08-24T12:00:00.000Z",
    "createdAt": "2026-08-24T12:00:00.000Z",
    "updatedAt": "2026-08-24T12:00:00.000Z"
  }
}