Api reference
Get a withdrawal
GET/api/merchant/withdrawals/{withdrawalId}
Request
Parameters
Prop
Type
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" }}