Skip to main content
POST
/
v1
/
withdrawals
{
  "amount": 500.00,
  "bankAccountNumber": "1234567890",
  "bankName": "Commercial Bank",
  "bankBranch": "Colombo Main"
}

{
  "id": "wd_abc123def456",
  "amount": 500.00,
  "status": "pending",
  "bankAccountNumber": "1234567890",
  "bankName": "Commercial Bank",
  "bankBranch": "Colombo Main",
  "createdAt": "2026-03-26T14:30:00Z"
}

​
Authentication

This endpoint requires a Bearer token in the Authorization header. 
Authorization: Bearer <your_jwt_token>

​
Body Parameters

​
amount
number
required
The amount to withdraw. Must not exceed the current available balance.
​
bankAccountNumber
string
required
The destination bank account number for the withdrawal.
​
bankName
string
required
The name of the bank (e.g., Commercial Bank, Bank of Ceylon, Sampath Bank).
​
bankBranch
string
required
The branch name or code of the bank.

​
Response

​
id
string
Unique identifier for the withdrawal request.
​
amount
number
The withdrawal amount.
​
status
string
The withdrawal status. Newly created withdrawals have the status pending.
​
bankAccountNumber
string
The destination bank account number.
​
bankName
string
The bank name.
​
bankBranch
string
The bank branch.
​
createdAt
string
ISO 8601 timestamp of when the withdrawal was requested.
Withdrawals are reviewed and processed by the admin team. You will receive a webhook notification when the withdrawal status changes to approved or rejected.
{
  "amount": 500.00,
  "bankAccountNumber": "1234567890",
  "bankName": "Commercial Bank",
  "bankBranch": "Colombo Main"
}

{
  "id": "wd_abc123def456",
  "amount": 500.00,
  "status": "pending",
  "bankAccountNumber": "1234567890",
  "bankName": "Commercial Bank",
  "bankBranch": "Colombo Main",
  "createdAt": "2026-03-26T14:30:00Z"
}