ZenPlugins

https://github.com/zenmoney/zenplugins
Admin
Community-developed plugins for Zenmoney that securely retrieve and convert bank account and...
Tokens:24,956
Snippets:110
Trust Score:6.7
License:GPL-3.0
Update:1 year ago
Show doc for...
Tokens:
Raw
### Install Project Dependencies with Yarn

Source: https://github.com/zenmoney/zenplugins/blob/master/docs/README.md

Installs project dependencies using Yarn. If Yarn is not installed, it provides instructions to install it globally via npm. Requires Node.js (16+) and npm.

```shell
git clone https://github.com/zenmoney/ZenPlugins.git
yarn
npm install --global yarn
```

--------------------------------

### ZenPlugins Development and Build Commands

Source: https://github.com/zenmoney/zenplugins/blob/master/docs/README.md

Provides commands for starting the development server, building the plugin, and running tests. The development server allows for debugging in the browser. Building creates a single file bundle for the plugin. Tests include type-checking, linting, and unit tests.

```shell
yarn start (PLUGIN NAME)
yarn build (PLUGIN NAME)
yarn test [PLUGIN NAME]
jest [PLUGIN NAME]
```

--------------------------------

### Create Transaction: Salary Deposit

Source: https://github.com/zenmoney/zenplugins/blob/master/docs/transactionsExamples.md

This example illustrates the structure of a transaction object representing a salary deposit. It includes the account receiving the funds, the amount, and merchant details, along with an optional comment.

```javascript
{
  hold: false,
  date: new Date('2021-06-10T00:00:00+03:00'),
  movements: [
    {
      id: null,
      account: { id: 'e2f532d7-13e9-4d16-bfda-614ed290679b' },
      invoice: null,
      sum: 40000,
      fee: 0
    }
  ],
  merchant: {
    country: 'RUS',
    city: 'MOSCOW',
    title: 'SBERBANK',
    mcc: null,
    location: null
  },
  comment: 'May 2021 salary' // useful comment
}
```

--------------------------------

### XML Zenmoney Manifest Configuration

Source: https://github.com/zenmoney/zenplugins/blob/master/docs/ZenmoneyManifest.xml.md

This XML file defines the manifest for a Zenmoney synchronization plugin. It specifies essential details like the plugin's ID, company identifier, a descriptive text, versioning information, and flags for modularity and user interaction during synchronization. Dependencies include standard XML parsing.

```xml
<?xml version="1.0" encoding="utf-8"?>
<provider>
    <id>example</id> <!--plugin name, same as directory name-->
    <company>0</company> <!-- internal zenmoney id, left it 0, during the merge we will fix to real one -->
    <description> <!--some additional info about bank synchronization-->
        Synchronization plugin example.
        Input your login and password from the bank.
    </description>
    <version>1.0</version> <!--legacy, don't change-->
    <build>1</build> <!--legacy, don't change-->
    <modular>true</modular> <!--legacy, don't change-->
    <files> <!--legacy, don't change-->
        <js>index.js</js>
        <preferences>preferences.xml</preferences>
    </files>
    <codeRequired>false</codeRequired> <!--optional (default true),
true means that plugin needs some interaction with user
during every synchronization (eg. get code from sms)
Setting it to false gives ability to set up automatic synchronization in background-->
</provider>
```

--------------------------------

### Session Redirect and Initialization (JavaScript)

Source: https://github.com/zenmoney/zenplugins/blob/master/src/plugins/altabanka-rs/__tests__/api/__mocks__/transactions-post-2.html

This code checks if the current window's name matches a specific GUID. If not, it redirects the user to the login page. It then sets the window's name to the GUID to prevent further redirects.

```javascript
if (window.name !== '12686488-18e6-45a2-ac42-0c74ecc26f4a') { Redirect('/altaonline/Identity/Login'); } window.name = '12686488-18e6-45a2-ac42-0c74ecc26f4a';
```

--------------------------------

### Example Reminder Configuration - JavaScript

Source: https://github.com/zenmoney/zenplugins/wiki/ZenMoney-API

This JavaScript example demonstrates how to configure a Reminder for weekly operations on specific days. It sets the interval to 'day', a step of 7 days, and points at indices 0, 2, and 4, corresponding to Wednesday, Friday, and Sunday respectively, assuming the startDate is a Wednesday. The operation is set to repeat weekly starting from '2017-03-08' indefinitely.

```javascript
{
    //...
    interval: 'day',
    step: 7,
    points: [0, 2, 4],
    startDate: '2017-03-08',
    endDate: null
    //...
}
```

--------------------------------

### Create Transaction: Transfer to Account with Card Number

Source: https://github.com/zenmoney/zenplugins/blob/master/docs/transactionsExamples.md

This example demonstrates a transaction where funds are transferred to an account identified by a masked card number. It shows how to specify the receiving account details, including its instrument and sync IDs.

```javascript
{
  hold: false,
  date: new Date('2021-06-27T04:44:32+03:00'),
  movements: [
    {
      id: null,
      account: { id: 'e2f532d7-13e9-4d16-bfda-614ed290679b' },
      invoice: null,
      sum: -10,
      fee: 0
    },
    {
      id: null,
      account: {
        type: null,
        instrument: 'RUB',
        company: null,
        syncIds: ['4019********3284']
      },
      invoice: null,
      sum: 10,
      fee: 0
    }
  ],
  merchant: {
    country: null,
    city: null,
    title: 'Nikolai',
    mcc: null,
    location: null
  },
  comment: 'Debt repayment'
}
```

--------------------------------

### Create Transaction: Transfer Between Two Accounts

Source: https://github.com/zenmoney/zenplugins/blob/master/docs/transactionsExamples.md

This example shows how to represent a transfer of funds between two accounts. The transaction object contains two movement entries, one for the debit and one for the credit, ensuring synchronization.

```javascript
{
  hold: false,
  date: new Date('2021-06-30T14:32:32+03:00'),
  movements: [
    {
      id: null,
      account: { id: 'e2f532d7-13e9-4d16-bfda-614ed290679b' },
      invoice: null,
      sum: -26.7,
      fee: 0
    },
    {
      id: null,
      account: { id: '5b909992-223f-4d9c-a6b9-ba3f29d68e3e' },
      invoice: null,
      sum: 26.7,
      fee: 0
    }
  ],
  merchant: null,
  comment: null
}
```

--------------------------------

### Create Transaction: Pay from UAH Card for Grocery

Source: https://github.com/zenmoney/zenplugins/blob/master/docs/transactionsExamples.md

This example demonstrates the structure of a transaction object for a grocery purchase made from a UAH (Ukrainian Hryvnia) card. It specifies that the transaction is not on hold and includes details about the account and merchant.

```javascript
{
  hold: false,
  date: new Date('2021-06-17T08:39:22+02:00'),
  movements: [
    {
      id: null,
      account: { id: '5b909992-223f-4d9c-a6b9-ba3f29d68e3e' },
      invoice: null,
      sum: -387.89,
      fee: 0
    }
  ],
  merchant: {
    country: 'UA',
    city: 'KYIV',
    title: 'SILPO',
    mcc: 5411,
    location: null
  },
  comment: null
}
```

--------------------------------

### EditTextPreference Example for Date Input

Source: https://github.com/zenmoney/zenplugins/blob/master/docs/preferences.xml.md

This snippet demonstrates the usage of EditTextPreference for capturing a date input. The `key` attribute 'startDate' is used to store the preference value, and it's marked as obligatory. The `inputType` is set to 'date'.

```xml
<EditTextPreference
    key="startDate"
    obligatory="true"
    inputType="date"
    title="From what date to load transactions"
    defaultValue="2018-01-01T00:00:00.000Z"
    dialogTitle="From what date to load transactions"
    positiveButtonText="OK"
    negativeButtonText="Cancel"
    summary="|startDate|{@s}"
/>
```

--------------------------------

### GET /v2/usermanagement/userinfo

Source: https://github.com/zenmoney/zenplugins/blob/master/src/plugins/tbc-ge/README.md

Retrieves detailed information about the logged-in user.

```APIDOC
## GET /v2/usermanagement/userinfo

### Description
Retrieves comprehensive user information, including personal details, security settings, and account-related flags. Requires authentication via cookies obtained from a successful login.

### Method
GET

### Endpoint
https://rmbgwauth.tbconline.ge/v2/usermanagement/userinfo

### Parameters
#### Headers
- **Cookie** (string) - Required - Cookies obtained from previous authentication steps (e.g., `.AspNetCore.tbc-customer-identity-rmb-cookies`, `TSxxx`).

### Response
#### Success Response (200)
- **userDcuId** (integer) - The user's DCU ID.
- **sessionId** (string) - The user's session ID.
- **firstNameEn** (string) - User's first name in English.
- **firstNameGe** (string) - User's first name in Georgian.
- **lastNameEn** (string) - User's last name in English.
- **lastNameGe** (string) - User's last name in Georgian.
- **birthday** (string) - User's birthday (timestamp).
- **lastLoginDate** (string) - Timestamp of the last login.
- **mobilePhoneForSms** (string) - User's mobile phone number for SMS.
- **username** (string) - User's username.
- **clientNameEn** (string) - User's full name in English.
- **clientNameGe** (string) - User's full name in Georgian.
- **resident** (boolean) - Indicates if the user is a resident.
- **securityDevices** (array) - List of security devices available for the user (e.g., `["SMS_OTP"]`).

#### Response Example
```json
{
    "parameters": {
        "corp2faPreferredCertMethod": "OTP"
    },
    "userDcuId": 17215000,
    "personId": null,
    "sessionId": "553ce000-0000-49b3-0000-08dc2f305473",
    "firstNameEn": "Name",
    "firstNameGe": "Name",
    "lastNameEn": "Surname",
    "lastNameGe": "Surname",
    "birthday": "631152000000",
    "lastLoginDate": "1708452433000",
    "email": null,
    "mobilePhoneForSms": "599555666",
    "username": "username",
    "mfaType": "2FA",
    "clientNameEn": "Name Surname",
    "clientNameGe": "სახელი გვარი",
    "clientSegment": "1",
    "externalClientId": "some numbers",
    "securityLevel": "MEDIUM",
    "resident": false,
    "isChecker": false,
    "isAdmin": false,
    "hasLinkForContextSwitch": false,
    "digitalUser": false,
    "signingRuleOperations": [],
    "showTrustedDevicePopup": true,
    "suggestExchangeRateEnabled": true,
    "preferredCertificationMethod": "OTP",
    "securityDevices": ["SMS_OTP"],
    "signingRoleCode": null,
    "operationTypes": [
        "3.46.01.00-02",
        "3.46.01.02-01",
        "3.46.01.03-01",
        ...
    ]
}
```
```

--------------------------------

### Create Transaction: Pay from RUB Card for Taxi with USD

Source: https://github.com/zenmoney/zenplugins/blob/master/docs/transactionsExamples.md

This example shows how to structure a transaction object for a payment made from a RUB account for a taxi service, where the transaction itself is in USD. It includes details about the account, invoice, merchant, and date.

```javascript
{
  hold: true,
  date: new Date('2021-05-30T17:34:00+03:00'),
  movements: [
    {
      id: '6136fae6f',
      account: { id: 'e2f532d7-13e9-4d16-bfda-614ed290679b' },
      invoice: { sum: -5, instrument: 'USD' },
      sum: -400,
      fee: 0
    }
  ],
  merchant: {
    fullTitle: 'NL AMSTERDAM UBER 748264',
    mcc: 4121,
    location: null
  },
  comment: null
}
```

--------------------------------

### EditTextPreference Example for Password Input

Source: https://github.com/zenmoney/zenplugins/blob/master/docs/preferences.xml.md

This snippet shows an example of using EditTextPreference to securely capture a password. The `inputType` is set to `textPassword` to mask the input. The `key` attribute 'password' is used for storage and is marked as obligatory.

```xml
<EditTextPreference
    key="password"
    obligatory="true"
    inputType="textPassword"
    title="Password"
    dialogTitle="Password"
    dialogMessage="Some detauls"
    positiveButtonText="OK"
    negativeButtonText="Cancel"
    summary="||***********"
/>
```

--------------------------------

### ZenMoney API - Network Requests (JavaScript)

Source: https://github.com/zenmoney/zenplugins/wiki/ZenPlugins-API

This snippet shows how to perform HTTP GET and POST requests using the ZenMoney API. ZenMoney.requestGet and ZenMoney.requestPost allow for sending requests to specified URLs with optional data and headers. The API handles default character encoding and Content-Type if not provided. Errors during requests will throw a ZenMoney.Error.

```javascript
// Example of making a POST request

var url = 'https://api.example.com/data';
var data = { key: 'value' };
var headers = { 'Content-Type': 'application/json' };

try {
    var response = ZenMoney.requestPost(url, data, headers);
    ZenMoney.trace('Response: ' + response);
} catch (e) {
    ZenMoney.trace('Error making request: ' + e.message);
}
```

--------------------------------

### TBC Bank User Info Retrieval API Request

Source: https://github.com/zenmoney/zenplugins/blob/master/src/plugins/tbc-ge/README.md

Retrieves detailed user information after successful authentication. This is a GET request to the TBC Bank user management endpoint, requiring the cookies obtained from the login process.

```http
GET /v2/usermanagement/userinfo HTTP/1.1
Host: rmbgwauth.tbconline.ge
Cookie: .AspNetCore.tbc-customer-identity-rmb-cookies=...; TSxxx=...; ...
```

--------------------------------

### Initialize Document Ready and Event Handlers (JavaScript/jQuery)

Source: https://github.com/zenmoney/zenplugins/blob/master/src/plugins/belarusbank/__tests__/parsers/accounts/cardAccount.html

This snippet initializes the document ready function and sets up event listeners for various UI elements. It includes handling clicks on table cells to expand/collapse accounts, toggling the visibility of elements with the 'spler' class, and applying AJAX fixes after content is loaded. It also makes an initial AJAX request to define an IP address.

```javascript
jQuery(document).ready(function() {
  try {
    let ajaxReq = $.ajax({
      url: "/wps/PA_rdclientCardsEpin/DefineIPAddress",
      type: "POST"
    });
  } catch (e) {}

  $(document).on('click touchstart','table.accountTable td:not(.tdAccountButton, .tdHiddenButton)', function(){
    if ($(this).closest('tr').hasClass('line_checked')) {
      $(this).closest('tr').find('.collapseAccountLink').click();
    } else {
      $(this).closest('tr').find('.expandAccountLink').click();
    }
  });

  $(document).on('click','.spler', function(){
    $(this).toggleClass('active');
    $(this).next().toggle();
  });

  applyAfterAjaxFixes();
});
```

--------------------------------

### POST /devicemanagement/api/v1/device/order

Source: https://github.com/zenmoney/zenplugins/blob/master/src/plugins/tbc-ge/README.md

Initiates the process to trust a registered device.

```APIDOC
## POST /devicemanagement/api/v1/device/order

### Description
Initiates the trust process for a previously registered device. This allows for easier logins without repeated SMS verification.

### Method
POST

### Endpoint
`https://rmbgwauth.tbconline.ge/devicemanagement/api/v1/device/order`

### Parameters
#### Query Parameters
- **sessionId** (string) - Required - The session ID obtained from user info (e.g., from Get user info endpoint).

### Request Body
- **deviceId** (string) - Required - The unique identifier for the device.
- **orderType** (string) - Required - The type of order, typically "Set" to establish trust.
- **sessionId** (string) - Required - The session ID obtained from user info.

### Request Example
```json
{
  "deviceId": "31546aaaa3a20000",
  "orderType": "Set",
  "sessionId": "553ce000-0000-49b3-0000-08dc2f305473"
}
```

### Response
#### Success Response (200)
- **orderId** (integer) - The ID for this order, used in the confirmation step.
- **authorizationMethod** (string) - The method required for authorization (e.g., "SMS").

#### Response Example
```json
{
  "orderId": 12345,
  "authorizationMethod": "SMS"
}
```
```

--------------------------------

### Show Loading Spinner and Options (JavaScript)

Source: https://github.com/zenmoney/zenplugins/blob/master/src/plugins/belarusbank/__tests__/cardAccount.html

This function displays a loading panel with a spinning indicator. It restarts the logout timer and uses provided spinner options. The visibility of the loading panel is set to 'visible', and the spinner is initialized. Dependencies include jQuery and a spinner plugin.

```javascript
function ccShowProgressLoading(){
  ccRestartLogoutTimer();
  try {
    document.getElementById('cc_loading').className = 'cc_loadingPanel';
    $("#cc_loading").css({"visibility":"visible"});
    var opts = getSpinnerOptions();
    $("#cc_loading").spin(opts);
  } catch (e) {}
};
```

--------------------------------

### POST /v1/auth/loginWithPassword

Source: https://github.com/zenmoney/zenplugins/blob/master/src/plugins/tbc-ge/README.md

Initiates the login process by sending username and password. It may require further authentication steps based on the response.

```APIDOC
## POST /v1/auth/loginWithPassword

### Description
This endpoint initiates the login process by sending user credentials. The response will indicate if further authentication steps, like SMS OTP, are required.

### Method
POST

### Endpoint
https://rmbgwauth.tbconline.ge/v1/auth/loginWithPassword

### Parameters
#### Request Body
- **username** (string) - Required - The user's username.
- **password** (string) - Required - The user's password in plain text.
- **language** (string) - Optional - The preferred language for the response (e.g., "en").
- **deviceInfo** (string) - Required - Base64 encoded JSON string containing device information.
- **deviceData** (string) - Required - Base64 encoded JSON string containing detailed device data.
- **deviceId** (string) - Required - A unique identifier for the device.

### Request Example
```json
{
    "username": "username",
    "password": "password",
    "language": "en",
    "deviceInfo": "base64string",
    "deviceData": "base64string",
    "deviceId": "31546aaaa3a20000"
}
```

### Response
#### Success Response (200)
- **signatures** (array) - An array of signature objects, if further authentication is required. Each object contains `status`, `type`, and `otpId`.
- **secondPhaseRequired** (boolean) - Indicates if a second phase of authentication is needed.
- **transactionId** (string) - A unique identifier for the transaction, used in subsequent calls if `secondPhaseRequired` is true.

#### Response Example
```json
{
    "signatures": [
        {
            "response": null,
            "status": "CHALLENGE",
            "challenge": null,
            "regenerateChallengeCount": null,
            "authenticationAccessToken": null,
            "authenticationCode": null,
            "signer": null,
            "type": "SMS_OTP",
            "authenticationCodeRsaPublicKey": null,
            "id": null,
            "otpId": "NONE"
        }
    ],
    "signature": null,
    "validEmail": false,
    "success": false,
    "passcodeDirty": null,
    "secondPhaseRequired": true,
    "accessToken": null,
    "changePasswordRequired": false,
    "changePasswordSuggested": false,
    "userSelectionRequired": false,
    "transactionId": "xxx-transactionId-xxx",
    "linkedProfiles": null,
    "possibleChallengeRegenTypes": ["SMS_OTP"]
}
```
```

--------------------------------

### POST /v1/auth/registerDevice

Source: https://github.com/zenmoney/zenplugins/blob/master/src/plugins/tbc-ge/README.md

Registers a new device for authentication purposes.

```APIDOC
## POST /v1/auth/registerDevice

### Description
Registers a new device with the authentication service. This is the first step in establishing a trusted device.

### Method
POST

### Endpoint
`https://rmbgwauth.tbconline.ge/v1/auth/registerDevice`

### Request Body
- **deviceName** (string) - Required - The name of the device.
- **passcode** (string) - Required - The passcode for the device. This should be saved.
- **deviceId** (string) - Required - The unique identifier for the device.
- **passcodeType** (string) - Required - The type of passcode (e.g., "NUMERIC_PASSCODE").

### Request Example
```json
{
    "deviceName": "Android ONEPLUS A5000 OnePlus OnePlus5",
    "passcode": "12345",
    "deviceId": "31546aaaa3a20000",
    "passcodeType": "NUMERIC_PASSCODE"
}
```

### Response
#### Success Response (200)
- **success** (boolean) - Indicates if the registration was successful.
- **registrationId** (string) - The ID generated for this registration. This should be saved.

#### Response Example
```json
{
    "success": true,
    "registrationId": "6d400fd9db3342e000ca689e000f67ee"
}
```
```

--------------------------------

### Initialize document ready and event listeners (JavaScript)

Source: https://github.com/zenmoney/zenplugins/blob/master/src/plugins/belarusbank/__tests__/parsers/accounts/cardAccount_2.html

This snippet initializes document ready state for jQuery and sets up event listeners for clicks on account table rows and elements with the 'spler' class. It also calls an `applyAfterAjaxFixes` function.

```javascript
jQuery(document).ready(function() {
  try {
    let ajaxReq = $.ajax({
      url: "/wps/PA_rdClientCards/DefineIPAddress",
      type: "POST"
    });
  } catch (e) {}

  $(document).on('click touchstart','table.accountTable td:not(.tdAccountButton, .tdHiddenButton)', function(){
    if ($(this).closest('tr').hasClass('line_checked')) {
      $(this).closest('tr').find('.collapseAccountLink').click();
    } else {
      $(this).closest('tr').find('.expandAccountLink').click();
    }
  });

  $(document).on('click','.spler', function(){
    $(this).toggleClass('active');
    $(this).next().toggle();
  });

  applyAfterAjaxFixes();
});
```

--------------------------------

### JavaScript Document Ready Initialization for Deposit Links

Source: https://github.com/zenmoney/zenplugins/blob/master/src/plugins/belarusbank/__tests__/parsers/accounts/depositAccount.html

This code runs when the document is ready. It initializes the 'show closed deposits' functionality, setting up the click handler for the expand link and updating the initial state of related UI elements based on whether closed deposits are present.

```javascript
jQuery(document).ready(function(){
  var idPrefix = "viewns\_Z7\_G1H611G0J0O340QFBVCNIV06R3\_\:DepositCSDListForm\:";
  var linkElem = document.getElementById(idPrefix + "linkExpand");
  if(showLink()){
    if (linkElem != null){
      document.getElementById(idPrefix + "ibDepositsCsdList").style.marginBottom='0px';
      linkElem.onclick = showClosedDeposits;
      if(document.getElementById(idPrefix + "closedDepoActive").value == "true"){
        document.getElementById(idPrefix + "linkActiveClosed").style.display='none';
        document.getElementById(idPrefix + "linkHideClosed").style.display='';
      } else {
        document.getElementById(idPrefix + "linkActiveClosed").style.display='';
        document.getElementById(idPrefix + "linkHideClosed").style.display='none';
      }
    }
  }
  jQuery(".ibButton.buttonCSD").on('click', function(){
    showProgressLoadingWithMessage();
  });
});
```

--------------------------------

### Displaying Progress Loading Indicator (JavaScript/jQuery)

Source: https://github.com/zenmoney/zenplugins/blob/master/src/plugins/belarusbank/__tests__/parsers/accounts/cardAccount.html

This function, `ccShowProgressLoading`, handles the display of a loading panel with a spinner. It restarts the logout timer, sets the visibility and class of the loading element, and initializes the spinner with specified options. It includes error handling for cases where elements might not be found.

```javascript
function ccShowProgressLoading(){
  ccRestartLogoutTimer();
  try {
    document.getElementById('cc_loading').className = 'cc_loadingPanel';
    $("#cc_loading").css({"visibility":"visible"});
    let opts = getSpinnerOptions();
    $("#cc_loading").spin(opts);
  } catch (e) {}
};
```

--------------------------------

### ZenMoney API - Logging and Preferences (JavaScript)

Source: https://github.com/zenmoney/zenplugins/wiki/ZenPlugins-API

This snippet demonstrates logging messages and retrieving plugin preferences using the ZenMoney API. ZenMoney.trace logs a message with an optional tag, while ZenMoney.getPreferences() retrieves the plugin's settings as a key-value object. These functions are fundamental for debugging and accessing configuration.

```javascript
// Example usage of ZenMoney.trace and ZenMoney.getPreferences()

var preferences = ZenMoney.getPreferences();
ZenMoney.trace('Login: ' + preferences.login, 'Auth');
ZenMoney.trace('Password: ' + preferences.password, 'Auth');
```

--------------------------------

### JavaScript for Initializing Filter UI

Source: https://github.com/zenmoney/zenplugins/blob/master/src/plugins/altabanka-rs/__tests__/api/__mocks__/transactions-post-1.html

This jQuery snippet runs when the document is ready. It copies the HTML content from a hidden element with the ID 'filter-values-new' to the element with the ID 'filter-values', effectively initializing the filter interface.

```javascript
$(document).ready(function () { $('#filter-values').html($('#filter-values-new').html()); });
```

--------------------------------

### Initialize Deposit Link Behavior - JavaScript (jQuery)

Source: https://github.com/zenmoney/zenplugins/blob/master/src/plugins/belarusbank/__tests__/parsers/accounts/depositAccount_1.html

This code runs when the document is ready. It initializes the behavior for a link that controls the visibility of closed deposits. It checks if closed deposits should be shown and sets up an event handler for the link to toggle their visibility. Requires jQuery.

```javascript
jQuery(document).ready(function(){
    var idPrefixDep = "viewns\_Z7\_G1H611G0J0O340QFBVCNIV0M80\_:DepositListForm\:";
    var linkElemDep = document.getElementById(idPrefixDep + "linkExpandDep");
    if(showOrHideDepLink()){
        if (linkElemDep != null){
            document.getElementById(idPrefixDep + "ibDepositList").style.marginBottom='0px';
            linkElemDep.onclick = showOrHideClosedDeposits;
            if(document.getElementById(idPrefixDep + "closedDepoActive").value == "true"){
                document.getElementById(idPrefixDep + "linkActiveClosed").style.display='none';
                document.getElementById(idPrefixDep + "linkHideClosed").style.display='';
            } else{
                document.getElementById(idPrefixDep + "linkActiveClosed").style.display='';
                document.getElementById(idPrefixDep + "linkHideClosed").style.display='none';
            }
        }
    }
});
```

--------------------------------

### Initialize AJAX Request and Event Listeners (JavaScript)

Source: https://github.com/zenmoney/zenplugins/blob/master/src/plugins/belarusbank/__tests__/cardAccount.html

This snippet initializes an AJAX request upon document ready and sets up event listeners for clicks on table rows and dropdown selections. It handles expanding/collapsing account details, toggling special features, and submitting forms based on user selections. Dependencies include jQuery.

```javascript
jQuery(document).ready(function() {
  try {
    var ajaxReq = $.ajax({
      url: "/wps/PA_rdClientCards/DefineIPAddress",
      type: "POST"
    });
  } catch (e) {}

  $(document).on('click touchstart','table.accountTable td:not(.tdAccountButton, .tdHiddenButton)', function(){
    if ($(this).closest('tr').hasClass('line_checked')) {
      $(this).closest('tr').find('.collapseAccountLink').click();
    } else {
      $(this).closest('tr').find('.expandAccountLink').click();
    }
  });

  $(document).on('click','.spler', function(){
    $(this).toggleClass('active');
    $(this).next().toggle();
  });

  applyAfterAjaxFixes();
});
```

--------------------------------

### POST /v1/auth/certifyLogin

Source: https://github.com/zenmoney/zenplugins/blob/master/src/plugins/tbc-ge/README.md

Completes the login process by verifying the SMS code provided by the user.

```APIDOC
## POST /v1/auth/certifyLogin

### Description
This endpoint is used to complete the login process after the initial `loginWithPassword` call, by providing the SMS code received via OTP.

### Method
POST

### Endpoint
https://rmbgwauth.tbconline.ge/v1/auth/certifyLogin

### Parameters
#### Request Body
- **transactionId** (string) - Required - The transaction ID obtained from the `loginWithPassword` response.
- **signature** (object) - Required - An object containing the authentication signature details.
    - **response** (string) - Required - The SMS code provided by the user.
    - **status** (string) - Required - Must be "CHALLENGE".
    - **type** (string) - Required - Must be "SMS_OTP".
    - **otpId** (string) - Required - Must be "NONE".
- **language** (string) - Optional - The preferred language for the response (e.g., "en").

### Request Example
```json
{
    "transactionId": "xxx-transactionId-xxx",
    "signature": {
        "response": "1234", 
        "status": "CHALLENGE",
        "type": "SMS_OTP",
        "otpId": "NONE"
    },
    "language": "en"
}
```

### Response
#### Success Response (200)
- **success** (boolean) - Indicates if the login certification was successful.
- **accessToken** (string) - The access token obtained after successful login.
- **signatures** (null) - Should be null upon successful certification.

#### Response Example
```json
{
    "success": true,
    "signatures": null,
    "transactionId": null,
    "accessToken": null,
    "linkedProfiles": null,
    "changePasswordRequired": false,
    "changePasswordSuggested": false,
    "userSelectionRequired": false,
    "possibleChallengeRegenTypes": null
}
```
```

--------------------------------

### ZenMoney API - User Input Prompt (JavaScript)

Source: https://github.com/zenmoney/zenplugins/wiki/ZenPlugins-API

This snippet shows how to prompt the user for input using the ZenMoney API. ZenMoney.retrieveCode displays a question to the user, optionally with an image, and allows specifying input type (e.g., text, number, password) and time limit. This is useful for interactive plugins.

```javascript
// Example of retrieving user input

var question = 'Please enter your username:';
var options = {
    time: 30000, // 30 seconds
    inputType: 'text'
};

var userInput = ZenMoney.retrieveCode(question, null, options);
ZenMoney.trace('User input: ' + userInput);
```

--------------------------------

### ZenMoney API Reference

Source: https://github.com/zenmoney/zenplugins/wiki/ZenPlugins-API

Reference for core ZenMoney API functions used within plugins.

```APIDOC
## ZenMoney API Functions

### ZenMoney.trace(msg: String, tag: String?)
Logs a message with an optional tag.

### ZenMoney.getPreferences() -> {String: String}
Retrieves plugin preferences.

### ZenMoney.Error(message: String?, logIsNotImportant: Bool?, forcePluginReinstall: Bool?) -> ZenMoney.Error
Constructor for ZenMoney errors with options for log importance and reinstall forcing.

### ZenMoney.setDefaultCharset(charset: String)
Sets the default character set for network requests.

### ZenMoney.requestGet(url: String, headers: {String: String}?)
Performs an HTTP GET request.

### ZenMoney.requestPost(url: String, data: Any?, headers: {String: String}?)
Performs an HTTP POST request.

### ZenMoney.request(method: String, url: String, data: Any?, headers: {String: String}?)
Performs an HTTP request with a specified method.

### ZenMoney.getLastUrl() -> Int?
Gets the URL of the last successful HTTP request.

### ZenMoney.getLastStatusCode() -> Int?
Gets the status code of the last HTTP response.

### ZenMoney.getLastResponseHeaders() -> [['header1', 'value1'], ...]?
Gets all headers of the last HTTP response.

### ZenMoney.getLastResponseHeader(header: String) -> String?
Gets a specific header from the last HTTP response.

### ZenMoney.retrieveCode(question: String, imageUrl: String?, options: {String: Any}?)
Prompts the user for a string input with an optional image and input options.

### ZenMoney.setData(key: String, value: Any?)
Sets a key-value pair in the plugin's data storage.

### ZenMoney.getData(key: String, defaultValue: Any?) -> Any?
Retrieves a value from the plugin's data storage with a default value.

### ZenMoney.saveData()
Saves the plugin's data to persistent storage.

### ZenMoney.clearData()
Clears all data from the plugin's storage.

### ZenMoney.isAccountSkipped(id: String) -> Bool
Checks if an account should be skipped by the plugin.
```

--------------------------------

### POST /v1/auth/easyLogin

Source: https://github.com/zenmoney/zenplugins/blob/master/src/plugins/tbc-ge/README.md

Performs an easy login using a registered device's passcode.

```APIDOC
## POST /v1/auth/easyLogin

### Description
Allows users to log in easily using a pre-set passcode on a registered and trusted device. If `trustedDeviceId` is omitted, an SMS code will be required.

### Method
POST

### Endpoint
`https://rmbgwauth.tbconline.ge/v1/auth/easyLogin`

### Request Body
- **userName** (string) - Required - The user's username.
- **passcode** (string) - Required - The passcode set during device registration.
- **registrationId** (string) - Required - The registration ID obtained during device registration.
- **deviceInfo** (object) - Required - Information about the device (structure same as in Login with password).
- **deviceData** (object) - Required - Data related to the device (structure same as in Login with password).
- **passcodeType** (string) - Required - The type of passcode used (e.g., "NUMERIC_PASSCODE").
- **language** (string) - Required - The preferred language for the response (e.g., "en").
- **deviceId** (string) - Required - The unique identifier for the device.
- **trustedDeviceId** (string) - Optional - The trust ID obtained after trusting the device. If omitted, an SMS code will be required.

### Request Example
```json
{
  "userName": "username",
  "passcode": "12345",
  "registrationId": "6d400fd9db3342e000ca689e000f67ee",
  "deviceInfo": {},
  "deviceData": {},
  "passcodeType": "NUMERIC_PASSCODE",
  "language": "en",
  "deviceId": "31546aaaa3a20000",
  "trustedDeviceId": "trustId"
}
```

### Response
(Details on success/error responses for easy login would typically be provided here, e.g., session tokens, user details, or error messages.)
```

--------------------------------

### TBC Bank Initial Login Response Handling

Source: https://github.com/zenmoney/zenplugins/blob/master/src/plugins/tbc-ge/README.md

Represents the initial response from TBC Bank after a login attempt. If 'secondPhaseRequired' is true and 'signatures' is not null, an SMS OTP is expected to proceed.

```json
{
    "signatures": [
        {
            "response": null,
            "status": "CHALLENGE",
            "challenge": null,
            "regenerateChallengeCount": null,
            "authenticationAccessToken": null,
            "authenticationCode": null,
            "signer": null,
            "type": "SMS_OTP",
            "authenticationCodeRsaPublicKey": null,
            "id": null,
            "otpId": "NONE"
        }
    ],
    "signature": null,
    "validEmail": false,
    "success": false,
    "passcodeDirty": null,
    "secondPhaseRequired": true,
    "accessToken": null,
    "changePasswordRequired": false,
    "changePasswordSuggested": false,
    "userSelectionRequired": false,
    "transactionId": "xxx-transactionId-xxx",
    "linkedProfiles": null,
    "possibleChallengeRegenTypes": ["SMS_OTP"]
}
```

--------------------------------

### JavaScript Functions for UI State Management

Source: https://github.com/zenmoney/zenplugins/blob/master/src/plugins/belarusbank/__tests__/accountWithoutBalanceAndCurrency.html

Provides functions to manage the UI state, including showing and hiding a progress loading indicator, restarting logout timers, and processing errors. It also includes functions to set selected account and card IDs.

```javascript
function ccShowProgressLoading() {
  ccRestartLogoutTimer();
  try {
    document.getElementById('cc_loading').className = 'cc_loadingPanel';
    $("#cc_loading").css({"visibility":"visible"});
    var opts = getSpinnerOptions();
    $("#cc_loading").spin(opts);
  } catch (e) {}
};

function ccRestartLogoutTimer() {
  try {
    //variable from time.js
    fulltime = 600; //seconds
  } catch (e) {}
};

function ccProcessError() {
  ccRestartLogoutTimer();
  //hideConfirmDialogs();
  ccHideProgressLoading();
  ccShowOnErrorMsg();
};

function setSelAcct(elem) {
  var account = $(elem).closest('table.ibTable').parent().find('table.accountTable');
  $(account).closest('.accountListContainer').find('input[id$="acctIdSelField"]').val($.trim(account.find('.tdId div').html()));
}

function setSelCard(elem) {
  var cardTr = $(elem).closest('td.tdCardDropdown').parent();
  $(cardTr).closest('.accountListContainer').find('input[id$="cardIdSelField"]').val($.trim(cardTr.find('.tdId div').html()));
  ccSelectedCardNumber = $.trim($(cardTr).find('td:nth-child(2) div.cellLable').html().replace(/(.*)(\s\(.*\)$)/g, '$1'));
  if ($.trim($(elem).val()).indexOf('miniStatement') != -1) {
    ccShowStmtConfirmDialog();
    $(elem).val('');
  } else if ($.trim($(elem).val()).indexOf('deleteExtraCard') != -1) {
    ccShowDelConfirmDialog();
    $(elem).val('');
  } else if ($.trim($(elem).val()) !== '') {
    showProgressLoadingWithMessage();
    $(elem).closest('form').submit();
  }
}

function ccHideProgressLoading() {
  try {
    document.getElementById('cc_loading').className = 'cc_loadingPanel';
    $("#cc_loading").css({"visibility":"hidden"});
    $("#cc_loading").spin(false);
  } catch (e) {}
};
```

--------------------------------

### Easy Login with Zenmoney Zenplugins

Source: https://github.com/zenmoney/zenplugins/blob/master/src/plugins/tbc-ge/README.md

Performs an easy login using the previously registered device and passcode. This method bypasses standard login procedures, offering a streamlined authentication experience. Include 'trustedDeviceId' to avoid SMS codes.

```json
{
  "userName": "username",
  "passcode": "12345",
  "registrationId": "6d400fd9db3342e000ca689e000f67ee",
  "deviceInfo": "same as in Login with password",
  "deviceData": "same as in Login with password",
  "passcodeType": "NUMERIC_PASSCODE",
  "language": "en",
  "deviceId": "31546aaaa3a20000",
  "trustedDeviceId": "trustId"
}
```

--------------------------------

### TBC Bank Login with Password API Request

Source: https://github.com/zenmoney/zenplugins/blob/master/src/plugins/tbc-ge/README.md

Initiates the login process by sending username and password to TBC Bank's authentication endpoint. Requires base64 encoded deviceInfo and deviceData, along with a static deviceId. The response indicates if a second phase (OTP) is required.

```json
{
    "username": "username",
    "password": "password",
    "language": "en",
    "deviceInfo": "base64string",
    "deviceData": "base64string",
    "deviceId": "31546aaaa3a20000"
}
```

--------------------------------

### POST /devicemanagement/api/v1/device/order/confirm

Source: https://github.com/zenmoney/zenplugins/blob/master/src/plugins/tbc-ge/README.md

Confirms the trust for a device after receiving an authorization code.

```APIDOC
## POST /devicemanagement/api/v1/device/order/confirm

### Description
Confirms the trust establishment for a device by providing the received authorization code (e.g., SMS code).

### Method
POST

### Endpoint
`https://rmbgwauth.tbconline.ge/devicemanagement/api/v1/device/order/confirm`

### Request Body
- **orderId** (integer) - Required - The order ID obtained from the `/device/order` endpoint.
- **authorizationCode** (string) - Required - The code received via SMS or other authorization methods.
- **orderType** (string) - Required - The type of order, should match the initial order (e.g., "Set").

### Request Example
```json
{
  "orderId": 12345,
  "authorizationCode": "received sms code",
  "orderType": "Set"
}
```

### Response
#### Success Response (200)
- **trustId** (string) - A unique ID representing the trusted device. This should be saved.
- **deviceId** (string) - The device ID that has been trusted.

#### Response Example
```json
{
  "trustId": "trustId",
  "deviceId": "31546aaaa3a20000"
}
```
```

--------------------------------

### Add ZenMoney Account and Transactions (JavaScript)

Source: https://github.com/zenmoney/zenplugins/wiki/ZenPlugins-API

This JavaScript snippet demonstrates how to add a new account and multiple transactions to ZenMoney using the ZenMoney API. It retrieves account details, then adds a card account, a cash withdrawal in RUB, a cash withdrawal in USD with an exchange rate, and a sample transaction with payee, MCC, and location data. It utilizes ZenMoney.getPreferences(), ZenMoney.requestPost(), ZenMoney.addAccount(), and ZenMoney.addTransaction().

```javascript
function main() {
    var auth = {
        login:    ZenMoney.getPreferences().login,
        password: ZenMoney.getPreferences().password
    };
    var account = JSON.parse(ZenMoney.requestPost(ACCOUNTS_URL, auth, {'Content-Type': 'application/json'}))[0];
    ZenMoney.addAccount({
        id: account.id,
        type: 'ccard',
        title: account.name,
        instrument: account.currency,
        syncID: [account.cardID.replace(/[^\d]+/, '')],
        balance: account.balance
    });
  
    ZenMoney.addTransaction({
        income: 1000,
        incomeAccount: 'cash#RUB',
        outcome: 1000,
        outcomeAccount: account.id,
        date: '2016-11-27'
    });
  
    ZenMoney.addTransaction({
        income: 5,
        incomeAccount: 'cash#USD',
        outcome: 63 * 5 + 10,
        outcomeAccount: account.id,
        date: '2016-11-28',
        opOutcome: 5,
        opOutcomeInstrument: 'USD'
    });
  
    ZenMoney.addTransaction({
        id: 'BE337E1A-3C1E-4867-89F4-6A9D89DD5073',
        income: 0,
        incomeAccount: account.id,
        outcome: 99,
        outcomeAccount: account.id,
        date: '2016-12-01',
        payee: 'McDonalds',
        mcc: 5814,
        latitude: 59.935214,
        longitude: 30.316683
    });
  
    ZenMoney.setResult({success: true});
}
```

--------------------------------

### HTML Notification Component

Source: https://github.com/zenmoney/zenplugins/blob/master/src/plugins/altabanka-rs/__tests__/api/__mocks__/transactions-post-1.html

A reusable HTML structure for displaying notifications to the user. It includes placeholders for dynamic content and a close button. The class 'notification' and 'close-btn' are used for styling and functionality respectively.

```html
<div id="{notification-id}" class="notification {color}"> <p> {notification-content} </p> <a href="#" class="close-btn" data-utility="closeNotification"></a> </div>
```

--------------------------------

### Show statement confirmation dialog (JavaScript)

Source: https://github.com/zenmoney/zenplugins/blob/master/src/plugins/belarusbank/__tests__/parsers/accounts/cardAccount_2.html

This function displays a confirmation dialog for viewing a mini statement. It retrieves confirmation text, replaces a placeholder with the selected card number, and makes the dialog visible. It also calls `ccShowDialogBackground`.

```javascript
function ccShowStmtConfirmDialog(){
  try{
    let idPrefix = "viewns_Z7_0AG41KO0J8GF30QURARU5U2O65_\\:ClientCardsDataForm\\:";
    let confirmTextElem = document.getElementById(idPrefix + "StmtConfirmText");
    if (ccStmtConfirmText == ''){
      ccStmtConfirmText = confirmTextElem.innerHTML;
    }
    confirmTextElem.innerHTML = ccStmtConfirmText.replace('{4}', ccSelectedCardNumber);
    document.getElementById("StmtConfirm").style.display = 'block';
    ccShowDialogBackground();
  }catch(e){}
};
```
Tokens:
Raw