Changelog​

New Webhook: Card Status Event​

You can now subscribe to the Card State Event webhook, which notifies your system in real time whenever a card is created or its status changes.

This webhook delivers a payload identical to the Retrieve Card Details.

A control signature is included in the api-notification-sign header (SHA512) to ensure authenticity and security.

📘 Learn how to configure webhooks: Webhooks Setup Guide

Changelog​

Enhancements to Existing Endpoints​

• The Account Top-Up Event webhook and the Retrieve Top-Up Details endpoint now support a new status value: allocating.
• The Retrieve Cards for an Account endpoint response now includes the availableBalance field for each card.
• The Retrieve Card Transactions endpoint now accepts two additional values for the types filter parameter:
  • top_up
  • withdrawal

Account Creation Response Structure Updated​

• The response for Create a New Account has been updated for consistency with other endpoints.
  The account ID is now returned inside a data object:

  Before:

  {
    "id": "8f3d0c3d-9f3e-4ef6-8fae-c3169025dfcb"
  }
  

  Now:

  {
    "data": {
      "id": "8f3d0c3d-9f3e-4ef6-8fae-c3169025dfcb"
    }
  }
  

Changelog​

Webhooks Support Added​

You can now configure webhooks in the Client Portal to receive real-time notifications when important events occur in your system. Webhooks allow your application to instantly react to events such as card transactions, account activity, or incoming top-ups.

📘 Full setup instructions: Webhooks Setup Guide

You can now subscribe to three webhook types:

• Card Transaction Event: Triggered whenever a card transaction is updated.
• Account Transaction Event: Triggered on any account-related transaction change.
• Account Top-Up Event: Triggered when funds are added to an account.

Card Balance Management​

This release introduces new capabilities for managing card balances.

New Endpoints​

• Top up card balance - you can now top up a card’s balance directly from the associated account.
• Withdraw card balance - you can now to withdraw funds from a card’s balance back to the account.

Enhancements to Existing Endpoints​

• Create a New Account
  The request body now supports the enableCardBalance parameter, allowing you to specify whether new accounts should support dedicated card balances.

• Retrieve Account Details
  The response now includes additional fields:

  • holdedBalance: Current holded (on-hold) balance of the account.
  • availableBalance: Current available balance of the account.
  • isUsedCardBalance: Indicates whether cards under this account have their own dedicated balance, or if all transactions are settled directly from the account balance.

• Retrieve Card Creation Restrictions
  The response now includes:

  • cardBalance: Shows if the provider supports issuing cards with a dedicated balance.

• Retrieve Card Details
  The response now includes:

  • availableBalance: The available balance on the card.
  • spendedBalance: The total amount spent from the card’s balance.

• Retrieve All Accounts for a Company
  The response now includes:

  • undistributedBalance: Current undistributed balance of the account.
  • holdedBalance: Current holded (on-hold) balance of the account.

• Retrieve Available Provider Accounts The response now includes:

  • supportedCardBalances: An array listing the supported card balance types for the provider account.
    Possible values:
    • personal_card_balance: Each card has its own dedicated balance, separate from the main account balance.
    • shared_account_balance: All cards share the main account balance; no individual card balances are maintained.
  • cardType: Indicates the card types that can be issued under this provider account.
    Possible values:
    • virtual: Card exists only in digital form (no physical plastic card is issued).
    • physical: Physical plastic card.

Changelog​

Fees​

This release introduces the ability to set and view custom fees for individual accounts.

• The fees object is now included in the following endpoints:
  • Retrieve Account Details
  • Create a New Account
  • Update Account
• This object contains detailed fee settings for:
  • cardTransactions: Fee for each card transaction.
  • cardIssuing: Fee for issuing a new card.
  • topUpsAllocation: Fee for allocating top-up funds.

Access Control and Permissions

• By default, you cannot manage account-level fees. To request access to fee management, please contact support.

Validation and Business Rules

• Any account-level fee (percentage or fixed) cannot be set lower than the corresponding company-level fee. This rule is enforced for all fee types and actions.