Api reference
List withdrawals
GET/api/merchant/withdrawals
Request
Parameters
Prop
Type
Responses
200 Withdrawals
Example response
{ "message": "withdrawals 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" } ]}