POST
/
customers
/
{customerId}
/
accounts
/
{accountId}
/
load-unload-balance
curl --request POST \
  --url https://api.next.orenda.finance/customers/{customerId}/accounts/{accountId}/load-unload-balance \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "amount": 5000,
  "action": "LOAD"
}
'
{
  "success": true,
  "accountId": "a1b2c3d4-5e6f-7081-92a3-b4c5d6e7f809",
  "action": "LOAD",
  "amount": 5000,
  "currency": "EUR",
  "balance": 17500,
  "adjustedAt": "2026-06-29T20:26:59.000Z"
}
{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "The request could not be processed. Check the request parameters and body and try again."
  }
}
{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "The request could not be processed. Check the request parameters and body and try again."
  }
}
{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "The request could not be processed. Check the request parameters and body and try again."
  }
}
{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "The request could not be processed. Check the request parameters and body and try again."
  }
}

Authorizations

​
Authorization
string
header
required

The back-office user's access token.

Path Parameters

​
customerId
string<uuid>
required

The customer's ID.

​
accountId
string<uuid>
required

The account's ID.

Query Parameters

​
programId
string
required

The program the customer/account belongs to. Required on every request.

Body

application/json
​
amount
integer
required

The amount to load or unload, in the account's minor currency units.

Example:

5000

​
action
enum<string>
required

Whether to add funds to (LOAD) or remove funds from (UNLOAD) the card balance.

Available options:
LOAD,
UNLOAD

Response

The card balance was adjusted with the provider.

Standard mutation envelope. Additional fields may be present depending on the operation.

​
success
boolean
Example:

true