Skip to main content
POST
/
v1
/
loans
/
{loan_id}
/
undo-disbursal
Undo disbursal
curl --request POST \
  --url https://api-staging.bsa.ai/v1/loans/{loan_id}/undo-disbursal \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "note": "<string>"
}
'

Documentation Index

Fetch the complete documentation index at: https://docs.lms.bsa.ai/llms.txt

Use this file to discover all available pages before exploring further.

Reverses a disbursement. The loan returns to approved state — the first step back from the Active state that POST /v1/loans lands at.
This is only safe if no repayment transactions have been recorded against the loan yet. Once a borrower has made any repayment, you must first reverse those transactions (see Reverse a repayment) before undoing the disbursal.
Two equivalent forms. Prefer the externalId form when you can — it lets you drive the rollback flow off your own loan reference. 
# By loan externalId (recommended)
curl -X POST "$BASE/v1/loans/external/halotel-tx-12345/undo-disbursal" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"note":"Wallet credit failed"}'

# Same effect, by LMS id
curl -X POST "$BASE/v1/loans/501/undo-disbursal" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"note":"Wallet credit failed"}'

​
Path parameters

​
loan_id
string
required

​
Request body

​
note
string
Optional. Reason for the reversal.

​
Example

curl -sf -X POST "$BASE/v1/loans/501/undo-disbursal" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"note": "Disbursed to wrong account"}'

​
Response

200 OK returns the loan object with status="Approved".

​
Errors

CodeWhen
not_foundNo loan with that ID
abortedLoan has repayments recorded, or is not in active state