Change Default Financial Account for A2A Transfers

This endpoint updates the default financial account used for Account-to-Account (A2A) transfers. It allows the authenticated user to designate a specific financial account as the default source or destination when initiating A2A transfers between internal accounts or to external accounts.

Endpoint

POST /settings/changeDefaultTransfersFinAccount

Authentication

Bearer token required. Obtain via:

POST https://api.banking.netevia.dev/api/auth/v2

Include in header: Authorization: Bearer {token}
Token lifetime: 10 minutes. Refresh via POST /api/auth/refresh.

When to use

Use this endpoint when a customer wants to change which financial account is used by default when initiating A2A transfers. This is useful after opening a new account, after closing an existing account, or when a customer simply prefers a different account as their primary transfer account. The setting persists until explicitly changed again.

Request Body

{
  "finAccountId": "fa_9b3c7e2d1a4f8056"
}

Response

200 OK

{
  "isChanged": true
}

Error Codes

Common Mistakes

• Providing a finAccountId that belongs to a different customer — the account must be owned by the authenticated user.
• Omitting finAccountId or passing a null value; the field is required for the update to take effect.
• Using a closed or inactive financial account as the new default, which will result in a 404 or 400 error.

Related Endpoints

• GET /settings — Retrieve current account settings, including the active default financial account for transfers.
• POST /transfers/a2a — Initiate an Account-to-Account transfer using the configured default financial account.
• GET /financialAccounts — List all financial accounts available for the authenticated customer.

Example

curl -X POST https://api.banking.netevia.dev/settings/changeDefaultTransfersFinAccount \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "finAccountId": "fa_9b3c7e2d1a4f8056"
  }'