Correct a payout account's details

PATCH/lokta-lms/api/v1/sourcing-partners/{partnerId}/bank-accounts/{bankAccountId}

Corrects the details of a payout account, with a reason.

Editable: beneficiary_name, bank_name, branch_name, account_type. Null leaves a field alone.

reason is required, unlike every other PATCH here. This is the record most worth changing fraudulently, the change log exists for exactly this write, and an unexplained edit is the shape a fraudulent one takes.

account_number and ifsc are not editable. A different account number is a different account: correcting one in place would silently re-point every future payout while keeping the row's identity, verification status and history, so the record would claim an account had been verified when the verified thing was a different account. Add the new account and promote it instead.

Path parameters

partnerIdpath · string · required

bankAccountIdpath · string · required

Header parameters

Idempotency-Keyheader · string · optional

Per-intent key

Request body application/json

reasonstring · required

Required, unlike other edits here. It is recorded in the change log.

beneficiary_namestring · optional

Null leaves the field alone.

bank_namestring · optional

Null leaves the field alone.

branch_namestring · optional

Null leaves the field alone.

account_typestring · optional

Null leaves the field alone.

One of: savings, current, od

Responses

defaultdefault response

Every request authenticates with HTTP Basic and carries a Tenant-Identifier header. See the conventions for dates, commands, pagination and errors. Open this operation in the interactive explorer, or read it as Markdown.

This is the API reference for Lokta, the agentic loan servicing platform. Go to lokta.ai

curl -X PATCH \ 'https://default.lokta.tech/lokta-lms/api/v1/sourcing-partners/{partnerId}/bank-accounts/{bankAccountId}' \ -u '{username}:{password}' \ -H 'Tenant-Identifier: default' \ -H 'Content-Type: application/json' \ -d '{ "reason": "string", "beneficiary_name": "string", "bank_name": "string", "branch_name": "string", "account_type": "savings" }'

import requests response = requests.patch( "https://default.lokta.tech/lokta-lms/api/v1/sourcing-partners/{partnerId}/bank-accounts/{bankAccountId}", auth=("{username}", "{password}"), headers={"Tenant-Identifier": "default"}, json={ "reason": "string", "beneficiary_name": "string", "bank_name": "string", "branch_name": "string", "account_type": "savings" }, ) print(response.json())

const response = await fetch("https://default.lokta.tech/lokta-lms/api/v1/sourcing-partners/{partnerId}/bank-accounts/{bankAccountId}", { method: "PATCH", headers: { Authorization: "Basic " + Buffer.from("{username}:{password}").toString("base64"), "Tenant-Identifier": "default", "Content-Type": "application/json", }, body: JSON.stringify({ "reason": "string", "beneficiary_name": "string", "bank_name": "string", "branch_name": "string", "account_type": "savings" }), }); console.log(await response.json());

HttpClient client = HttpClient.newHttpClient(); HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://default.lokta.tech/lokta-lms/api/v1/sourcing-partners/{partnerId}/bank-accounts/{bankAccountId}")) .header("Authorization", "Basic " + Base64.getEncoder().encodeToString("{username}:{password}".getBytes())) .header("Tenant-Identifier", "default") .header("Content-Type", "application/json") .method("PATCH", HttpRequest.BodyPublishers.ofString(""" { "reason": "string", "beneficiary_name": "string", "bank_name": "string", "branch_name": "string", "account_type": "savings" } """)) .build(); HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.body());

payload := strings.NewReader(`{ "reason": "string", "beneficiary_name": "string", "bank_name": "string", "branch_name": "string", "account_type": "savings" }`) req, _ := http.NewRequest("PATCH", "https://default.lokta.tech/lokta-lms/api/v1/sourcing-partners/{partnerId}/bank-accounts/{bankAccountId}", payload) req.SetBasicAuth("{username}", "{password}") req.Header.Set("Tenant-Identifier", "default") req.Header.Set("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() data, _ := io.ReadAll(res.Body) fmt.Println(string(data))