{
"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"
}
Settlements
Create Withdrawal
Request a withdrawal of available funds to your bank account
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 theAuthorization header.
Authorization: Bearer <your_jwt_token>
Body Parameters
number
required
The amount to withdraw. Must not exceed the current available balance.
string
required
The destination bank account number for the withdrawal.
string
required
The name of the bank (e.g.,
Commercial Bank, Bank of Ceylon, Sampath Bank).string
required
The branch name or code of the bank.
Response
string
Unique identifier for the withdrawal request.
number
The withdrawal amount.
string
The withdrawal status. Newly created withdrawals have the status
pending.string
The destination bank account number.
string
The bank name.
string
The bank branch.
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"
}