Skip to main content

Withdrawals

Request Withdrawal (API Key)

POST /business/withdrawal/request
curl -X POST "https://api.nexapay.ng/api/v1/business/withdrawal/request" \
  -H "Content-Type: application/json" \
  -H "x-api-key: nexa-prod-..." \
  -d '{"businessId":"664b...","amount":10000}'

Response

{
  "success": true,
  "msg": "Withdrawal successful",
  "withdrawal": {
    "transactionId": "NEXA-...",
    "amount": 10000,
    "bankAccount": "0123456789",
    "status": "COMPLETED"
  }
}

Invalid Example (Insufficient Balance)

{
  "success": false,
  "msg": "Insufficient balance. You have ₦0"
}

Withdrawal History (JWT)

GET /business/withdrawal/history
curl "https://api.nexapay.ng/api/v1/business/withdrawal/history" \
  -H "Authorization: Bearer <token>"

Response

{
  "success": true,
  "withdrawals": [
    {
      "transactionId": "NEXA-...",
      "amount": 10000,
      "status": "COMPLETED",
      "bankAccount": "0123456789"
    }
  ]
}

Error Response

{
  "success": false,
  "msg": "Server error"
}