curl --request POST \
--url https://api.next.orenda.finance/v1/customers/{customerId}/accounts/{accountId}/close \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"reason": "Suspected fraudulent activity reported by the customer."
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({reason: 'Suspected fraudulent activity reported by the customer.'})
};
fetch('https://api.next.orenda.finance/v1/customers/{customerId}/accounts/{accountId}/close', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.next.orenda.finance/v1/customers/{customerId}/accounts/{accountId}/close"
payload = { "reason": "Suspected fraudulent activity reported by the customer." }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"success": true,
"data": {
"status": "closed"
}
}Close an account
Closes the account permanently from the back office and closes its linked cards. A blocked account can be closed. A closed account cannot be reopened — the customer would need a new account. The supplied reason is stored on the account’s status history for audit.
The account must belong to the customerId in the path; any other account returns 404. Any status other than CLOSED can be closed, and the balance is not checked. The new status is saved before the provider, fee and card steps run and stays saved if one of them fails (500).
curl --request POST \
--url https://api.next.orenda.finance/v1/customers/{customerId}/accounts/{accountId}/close \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"reason": "Suspected fraudulent activity reported by the customer."
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({reason: 'Suspected fraudulent activity reported by the customer.'})
};
fetch('https://api.next.orenda.finance/v1/customers/{customerId}/accounts/{accountId}/close', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.next.orenda.finance/v1/customers/{customerId}/accounts/{accountId}/close"
payload = { "reason": "Suspected fraudulent activity reported by the customer." }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"success": true,
"data": {
"status": "closed"
}
}Authorizations
The back-office user's id_token — the ID token, not the access_token. The API rejects access tokens.
Path Parameters
The customer's ID.
The account's ID.
Query Parameters
The program the customer/account belongs to. Required on every request.
Body
Why the status is changing — stored on the account's status history for audit. Trimmed, and must not be blank after trimming; no other keys are accepted.
1