Реквизиты

Реквизиты пайщика используются для совершения платежей при возврате паевых взносов.

Для добавления реквизитов необходимо нажать на кнопку "Добавить" в шапке страницы, что откроет всплывающее окно с выбором типа реквизитов. На текущий момент доступны два типа: Система Быстрых Платежей (СБП) и Банковский Перевод. После выборе типа реквизитов, вводе данных и добавлении, реквизиты становятся доступными для получения платежей на них.

Разработчикам

Канонические имена полей и типов — в файле components/controller/schema.gql монорепозитория; интерактивно — в документации GraphQL-API.

Список платёжных методов

🛠️ SDK: Queries.PaymentMethods.GetPaymentMethods | Query.getPaymentMethods

Получить список методов оплаты Требуемые роли: chairman. Исключение: доступ разрешен, если

data.username

совпадает с

username

текущего пользователя.

import { Queries } from '@coopenomics/sdk';

const variables: Queries.PaymentMethods.GetPaymentMethods.IInput = {
  data: {
    limit: <number>; // Количество элементов на странице
    page: <number>; // Номер страницы
    sortBy?: <null | string>; // Ключ сортировки (например, "name")
    sortOrder: <string>; // Направление сортировки ("ASC" или "DESC")
    username?: <null | string>; // Имя пользователя для фильтрации методов оплаты
  };
};

const { [Queries.PaymentMethods.GetPaymentMethods.name]: result } = await client.Query(
  Queries.PaymentMethods.GetPaymentMethods.query,
  { variables }
);

Результат:

interface IOutput {
  getPaymentMethods: {
    currentPage: <number>; // Текущая страница
    items: <{
        created_at: <unknown>; // Дата создания
        data: <unknown>; // Данные метода оплаты
        is_default: <boolean>; // Флаг основного метода платежа, который отображается в документах
        method_id: <string>; // Идентификатор метода оплаты
        method_type: <string>; // Тип метода оплаты (например, sbp, bank_transfer)
        updated_at: <unknown>; // Дата обновления
        username: <string>; // Имя пользователя, к которому привязан метод оплаты
      }[]>; // Элементы текущей страницы
    totalCount: <number>; // Общее количество элементов
    totalPages: <number>; // Общее количество страниц
  };
}

Добавить реквизиты

🛠️ SDK: Mutations.PaymentMethods.AddPaymentMethod | Mutation.addPaymentMethod

Добавить метод оплаты (банковский счёт или СБП)

import { Mutations } from '@coopenomics/sdk';

const variables: Mutations.PaymentMethods.AddPaymentMethod.IInput = {
  data: {
    bank_transfer_data?: <null | {
        account_number: <string>; // Номер банковского счета
        bank_name: <string>; // Название банка
        card_number?: <null | string>; // Номер карты
        currency: <string>; // Валюта счета
        details: {
          bik: <string>; // БИК банка
          corr: <string>; // Корреспондентский счет
          kpp: <string>; // КПП банка
        };
      }>; // Данные для банковского перевода
    is_default: <boolean>; // Флаг основного метода платежа, который отображается в документах
    sbp_data?: <null | {
        phone: <string>; // Мобильный телефон получателя
      }>; // Данные для оплаты через СБП
    username: <string>; // Имя аккаунта пользователя
  };
};

const { [Mutations.PaymentMethods.AddPaymentMethod.name]: result } = await client.Mutation(
  Mutations.PaymentMethods.AddPaymentMethod.mutation,
  { variables }
);

Результат:

interface IOutput {
  addPaymentMethod: {
    created_at: <unknown>; // Дата создания
    data: <unknown>; // Данные метода оплаты
    is_default: <boolean>; // Флаг основного метода платежа, который отображается в документах
    method_id: <string>; // Идентификатор метода оплаты
    method_type: <string>; // Тип метода оплаты (например, sbp, bank_transfer)
    updated_at: <unknown>; // Дата обновления
    username: <string>; // Имя пользователя, к которому привязан метод оплаты
  };
}

Обновить банковский счёт

🛠️ SDK: Mutations.PaymentMethods.UpdateBankAccount | Mutation.updateBankAccount

Обновить банковский счёт

import { Mutations } from '@coopenomics/sdk';

const variables: Mutations.PaymentMethods.UpdateBankAccount.IInput = {
  data: {
    data: {
      account_number: <string>; // Номер банковского счета
      bank_name: <string>; // Название банка
      card_number?: <null | string>; // Номер карты
      currency: <string>; // Валюта счета
      details: {
        bik: <string>; // БИК банка
        corr: <string>; // Корреспондентский счет
        kpp: <string>; // КПП банка
      };
    };
    is_default: <boolean>; // Флаг основного метода платежа, который отображается в документах
    method_id: <string>; // Идентификатор платежного метода
    username: <string>; // Имя аккаунта пользователя
  };
};

const { [Mutations.PaymentMethods.UpdateBankAccount.name]: result } = await client.Mutation(
  Mutations.PaymentMethods.UpdateBankAccount.mutation,
  { variables }
);

Результат:

interface IOutput {
  updateBankAccount: {
    created_at: <unknown>; // Дата создания
    data: <unknown>; // Данные метода оплаты
    is_default: <boolean>; // Флаг основного метода платежа, который отображается в документах
    method_id: <string>; // Идентификатор метода оплаты
    method_type: <string>; // Тип метода оплаты (например, sbp, bank_transfer)
    updated_at: <unknown>; // Дата обновления
    username: <string>; // Имя пользователя, к которому привязан метод оплаты
  };
}

Удалить платёжный метод

🛠️ SDK: Mutations.PaymentMethods.DeletePaymentMethod | Mutation.deletePaymentMethod

Удалить метод оплаты

import { Mutations } from '@coopenomics/sdk';

const variables: Mutations.PaymentMethods.DeletePaymentMethod.IInput = {
  data: {
    method_id: <string>; // Идентификатор метода оплаты
    username: <string>; // Имя пользователя, чей метод оплаты нужно удалить
  };
};

const { [Mutations.PaymentMethods.DeletePaymentMethod.name]: result } = await client.Mutation(
  Mutations.PaymentMethods.DeletePaymentMethod.mutation,
  { variables }
);

Результат:

interface IOutput {
  deletePaymentMethod: <boolean>; // Удалить метод оплаты
}