simbiat/accountkeying
Composer 安装命令:
composer require simbiat/accountkeying
包简介
Library to do account keying based on logic from Central Bank of Russia.
README 文档
README
Implementation of Central Bank of Russia's logic in account keying, which allows validation of account numbers.
How to use
Quite easy and obvious:
\Simbiat\BIC\AccountKeying::accCheck('123456789', '12345678901234567890');
That's it. It will return either true or false. First number is BIC number, the 2nd one - account you are checking.
Algorithm as per CBR
ПОРЯДОК РАСЧЕТА КОНТРОЛЬНОГО КЛЮЧА
В НОМЕРЕ ЛИЦЕВОГО СЧЕТА
ПОРЯДОК
ЦЕНТРАЛЬНЫЙ БАНК РФ
8 сентября 1997 г.
N 515
(Д)
Схема обозначения лицевых счетов, приведенная в Правилах ведения бухгалтерского учета в кредитных организациях, расположенных на территории Российской Федерации, утвержденных Приказом Банка России N 02-263 от 18.06.97, предполагает наличие контрольного (защитного) ключа, значение которого рассчитывается в соответствии со следующим Порядком.
-
Контрольный ключ предназначен для проверки правильности номера лицевого счета при обработке расчетно-денежных документов.
-
Для расчета контрольного ключа используется совокупность двух реквизитов - условного номера РКЦ (если лицевой счет открыт в РКЦ) или кредитной организации (если лицевой счет открыт в кредитной организации) и номера лицевого счета.
Контрольный ключ (К) ______________________ | Порядковые номера разрядов _______________________________
---------------- ----------------------------------------------------------------------------------------------------- | | 1 | 2 | 3 | | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 |____|
| |_________________________________________________ |_____________Условный номер РКЦ или кредитной организации
-
Значение трехзначного условного номера РКЦ соответствует разрядам 5 и 6 банковского идентификационного кода (БИК), дополненным слева нулем до трех разрядов.
-
Значение условного номера кредитной организации соответствует разрядам 7,8 и 9 БИК.
-
Контрольный ключ рассчитывается с использованием весовых коэффициентов, устанавливаемых каждому разряду: Порядковые номера разрядов _______________________________ ---------------- ----------------------------------------------------------------------------------------------------- | | 1 | 2 | 3 | | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 || ___ ---------------- ----------------------------------------------------------------------------------------------------- | | 7 | 1 | 3 | | 7 | 1 | 3 | 7 | 1 | 3 | 7 | 1 | 3 | 7 | 1 | 3 | 7 | 1 | 3 | 7 | 1 | 3 | 7 | 1 | | ---------------- ----------------------------------------------------------------------------------------------------- |________ Весовые коэффициенты
-
Алгоритм расчета контрольного ключа: 6.1. Значение контрольного ключа приравнивается нулю (К=0). 6.2. Рассчитываются произведения значений разрядов на соответствующие весовые коэффициенты. 6.3. Рассчитывается сумма значений младших разрядов полученных произведений. 6.4. Младший разряд вычисленной суммы умножается на 3. Значение контрольного ключа (К) принимается равным младшему разряду полученного произведения.
-
Алгоритм проверки правильности контрольного ключа: 7.1. Рассчитываются произведения значений разрядов на соответствующие весовые коэффициенты с учетом контрольного ключа. 7.2. Рассчитывается сумма младших разрядов полученных произведений. При получении суммы, кратной 10 (младший разряд равен 0), значение контрольного ключа считается верным.
-
При наличии алфавитного значения в 6-ом разряде лицевого счета (в случае использования клиринговой валюты), данный символ заменяется на соответствующую цифру:
| Допустимое алфавитное значение 6-го разряда | A | B | C | E | H | K | M | P | T | X | | номера лицевого счета | | | | | | | | | | |
| Соответствующая цифра | 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 |
После выполнения замены расчет и проверка значения контрольного ключа производится в соответствии с п. 6 и п. 7. Настоящий Порядок вводится с 1 января 1998 г. С вводом в действие настоящего Порядка утрачивает силу письмо Департамента информатизации Банка России N 16-5-2/1198 от 12 сентября 1996 г. Доведите настоящий Порядок до учреждений Банка России и кредитных организаций.
Примеры расчета контрольного ключа
1. Пример расчета контрольного ключа в корреспондентском счете
Определить значение контрольного ключа (К) в корреспондентском счете кредитной организации 30101810К00000000746. Счет открыт в РКЦ, имеющем БИК 049805000.
- Выделяется условный номер РЦК - 005 (5-6 разряды БИК, дополненные слева нулем).
- В номере корреспондентского счета приравнивается нулю значение контрольного ключа (К=0) - 30101810000000000746.
- Определяется произведение каждого разряда условного номера РКЦ и номера корреспондентского счета на соответствующий весовой коэффициент:
_______ Условный номер РКЦ (дополненный нулем) Номер корреспондентского счета_______________________________________________ | ---------------- ----------------------------------------------------------------------------------------------------- | || 0 | 0 | 5 | | 3 | 0 | 1 | 0 | 1 | 8 | 1 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 7 | 4 | 6 || ---------------- ----------------------------------------------------------------------------------------------------- | | 7 | 1 | 3 | | 7 | 1 | 3 | 7 | 1 | 3 | 7 | 1 | 3 | 7 | 1 | 3 | 7 | 1 | 3 | 7 | 1 | 3 | 7 | 1 | | ---------------- ----------------------------------------------------------------------------------------------------- | | | 0 | 0 | 15 | | 21 | 0 | 3 | 0 | 1 | 24 | 7 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 21 | 28 | 6 | | | ---------------- ----------------------------------------------------------------------------------------------------- | | Произведения разрядов на соответствующие весовые коэффициенты | |______ Весовые коэффициенты
- Вычисляется сумма младших разрядов полученных произведений: 5+1+3+1+4+7+1+8+6=36.
- Младший разряд вычисленной суммы (6) умножается на 3 (6*3=18). Младший разряд полученного произведения (8) принимается в качестве значения контрольного ключа. Номер корреспондентского счета - 30101810800000000746.
- Правильность расчета контрольного ключа осуществляется повторным расчетом суммы младших разрядов произведений с учетом полученного значения контрольного ключа:
| 0 | 0 | 5 | | 3 | 0 | 1 | 0 | 1 | 8 | 1 | 0 | 8 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 7 | 4 | 6 |
| 7 | 1 | 3 | | 7 | 1 | 3 | 7 | 1 | 3 | 7 | 1 | 3 | 7 | 1 | 3 | 7 | 1 | 3 | 7 | 1 | 3 | 7 | 1 |
| 0 | 0 | 15 | | 21 | 0 | 3 | 0 | 1 | 24 | 7 | 0 | 24 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 21 | 28 | 6 |
|__________ Сумма младших разрядов произведений = 5+1+3+1+4+7+4+1+8+6 = 40 _____________________________________________|
Так как младший разряд суммы равен 0, контрольный ключ рассчитан верно.
2. Пример расчета контрольного ключа в лицевом счете клиента РКЦ
Определить значение контрольного ключа (К) в лицевом счете клиента РКЦ 40102810К00000010001. Счет открыт в РКЦ, имеющем БИК 040305000.
- Выделяется условный номер РЦК - 005 (5-6 разряды БИК, дополненные слева нулем).
- В номере лицевого счета приравнивается нулю значение контрольного ключа (К=0) - 40102810000000010001.
- Определяется произведение каждого разряда условного номера РКЦ и номера лицевого счета на соответствующий весовой коэффициент:
_______ Условный номер РКЦ (дополненный нулем) Номер лицевого счета_________________________________________________________ | ---------------- ----------------------------------------------------------------------------------------------------- | || 0 | 0 | 5 | | 4 | 0 | 1 | 0 | 2 | 8 | 1 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 1 | 0 | 0 | 0 | 1 || ---------------- ----------------------------------------------------------------------------------------------------- | | 7 | 1 | 3 | | 7 | 1 | 3 | 7 | 1 | 3 | 7 | 1 | 3 | 7 | 1 | 3 | 7 | 1 | 3 | 7 | 1 | 3 | 7 | 1 | | ---------------- ----------------------------------------------------------------------------------------------------- | | | 0 | 0 | 15 | | 28 | 0 | 3 | 0 | 2 | 24 | 7 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 7 | 0 | 0 | 0 | 1 | | | ---------------- ----------------------------------------------------------------------------------------------------- | | Произведения разрядов на соответствующие весовые коэффициенты | |______ Весовые коэффициенты
- Вычисляется сумма младших разрядов полученных произведений: 5+8+3+2+4+7+7+1=37.
- Младший разряд вычисленной суммы (7) умножается на 3 (7*3=21). Младший разряд полученного произведения (1) принимается в качестве значения контрольного ключа. Номер лицевого счета - 30101810100000000746.
- Правильность расчета контрольного ключа осуществляется повторным расчетом суммы младших разрядов произведений с учетом полученного значения контрольного ключа:
| 0 | 0 | 5 | | 4 | 0 | 1 | 0 | 2 | 8 | 1 | 0 | 1 | 0 | 0 | 0 | 0 | 0 | 0 | 1 | 0 | 0 | 0 | 1 |
| 7 | 1 | 3 | | 7 | 1 | 3 | 7 | 1 | 3 | 7 | 1 | 3 | 7 | 1 | 3 | 7 | 1 | 3 | 7 | 1 | 3 | 7 | 1 |
| 0 | 0 | 15 | | 28 | 0 | 3 | 0 | 2 | 24 | 7 | 0 | 3 | 0 | 0 | 0 | 0 | 0 | 0 | 7 | 0 | 0 | 0 | 1 |
|__________ Сумма младших разрядов произведений = 5+8+3+2+4+7+3+7+1 = 40 _______________________________________________|
Так как младший разряд суммы равен 0, контрольный ключ рассчитан верно.
3. Пример расчета контрольного ключа в лицевом счете клиента кредитной организации
Определить значение контрольного ключа (К) в лицевом счете клиента кредитной организации 40602810К00000000025. Кредитная организация, в которой открыт лицевой счет, имеет БИК 049805746.
- Выделяется условный номер кредитной организации - 746 (7-9 разряды БИК).
- В номере лицевого счета приравнивается нулю значение контрольного ключа (К=0) - 40602810000000000025.
- Определяется произведение каждого разряда условного номера кредитной организации и номера лицевого счета на соответствующий весовой коэффициент:
_______ Условный номер кредитной организации Номер лицевого счета___________________________________________________________ | ---------------- ----------------------------------------------------------------------------------------------------- | || 7 | 4 | 6 | | 4 | 0 | 6 | 0 | 2 | 8 | 1 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 2 | 5 || ---------------- ----------------------------------------------------------------------------------------------------- | | 7 | 1 | 3 | | 7 | 1 | 3 | 7 | 1 | 3 | 7 | 1 | 3 | 7 | 1 | 3 | 7 | 1 | 3 | 7 | 1 | 3 | 7 | 1 | | ---------------- ----------------------------------------------------------------------------------------------------- | | | 49 | 4 | 18 | | 28 | 0 | 18 | 0 | 2 | 24 | 7 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 7 | 0 | 0 | 14 | 5 | | | ---------------- ----------------------------------------------------------------------------------------------------- | | Произведения разрядов на соответствующие весовые коэффициенты | |______ Весовые коэффициенты
- Вычисляется сумма младших разрядов полученных произведений: 9+4+8+8+8+2+4+7+4+5=59
- Младший разряд вычисленной суммы (9) умножается на 3 (9*3=27). Младший разряд полученного произведения (7) принимается в качестве значения контрольного ключа. Номер лицевого счета - 40602810700000000025.
- Правильность расчета контрольного ключа осуществляется повторным расчетом суммы младших разрядов произведений с учетом полученного значения контрольного ключа:
| 7 | 4 | 6 | | 4 | 0 | 6 | 0 | 2 | 8 | 1 | 0 | 7 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 2 | 5 |
| 7 | 1 | 3 | | 7 | 1 | 3 | 7 | 1 | 3 | 7 | 1 | 3 | 7 | 1 | 3 | 7 | 1 | 3 | 7 | 1 | 3 | 7 | 1 |
| 49 | 4 | 18 | | 28 | 0 | 18 | 0 | 2 | 24 | 7 | 0 | 21 | 0 | 0 | 0 | 0 | 0 | 0 | 7 | 0 | 0 | 14 | 5 |
|__________ Сумма младших разрядов произведений = 9+4+8+8+8+2+4+7+1+4+5=60 ______________________________________________|
Так как младший разряд суммы равен 0, контрольный ключ рассчитан верно.
4. Пример расчета контрольного ключа в лицевом счете при использовании клиринговой валюты
Определить значение контрольного ключа (К) в лицевом счете клиента кредитной организации 30114B84К00000000501. Кредитная организация, в которой открыт счет, имеет БИК 044541312.
- Выделяется условный номер кредитной организации - 312 (7-9 разряды БИК).
- В номере корреспондентского счета приравнивается нулю значение контрольного ключа (К=0) и в соответствии с п. 8 Правил расчета выполняется временная замена алфавитного символа кода валюты (буква В)соответствующей ему цифрой (1) - 30114184000000000501.
- Определяется произведение каждого разряда условного номера кредитной организации и номера лицевого счета на соответствующий весовой коэффициент:
_______ Условный номер кредитной организации Номер лицевого счета_____________________________________________ | ---------------- ----------------------------------------------------------------------------------------------------- | || 3 | 1 | 2 | | 3 | 0 | 1 | 1 | 4 | 1 | 8 | 4 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 5 | 0 | 1 || ---------------- ----------------------------------------------------------------------------------------------------- | | 7 | 1 | 3 | | 7 | 1 | 3 | 7 | 1 | 3 | 7 | 1 | 3 | 7 | 1 | 3 | 7 | 1 | 3 | 7 | 1 | 3 | 7 | 1 | | ---------------- ----------------------------------------------------------------------------------------------------- | | | 21 | 1 | 6 | | 21 | 0 | 3 | 7 | 4 | 3 | 56 | 4 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 15 | 0 | 1 | | | ---------------- ----------------------------------------------------------------------------------------------------- | | Произведения разрядов на соответствующие весовые коэффициенты | |______ Весовые коэффициенты
- Вычисляется сумма младших разрядов полученных произведений: 1+1+6+1+3+7+4+3+6+4+5+1=42.
- Младший разряд вычисленной суммы (2) умножается на 3 (2*3=6). Младший разряд полученного произведения (6) принимается в качестве значения контрольного ключа. Номер лицевого счета с учетом представления 6-го разряда в виде буквы - 30114B84600000000501.
- Правильность расчета контрольного ключа осуществляется повторным расчетом суммы младших разрядов произведений с учетом полученного значения контрольного ключа и предварительной замены алфавитного символа на соответствующую цифру:
| 3 | 1 | 2 | | 3 | 0 | 1 | 1 | 4 | 1 | 8 | 4 | 6 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 5 | 0 | 1 |
| 7 | 1 | 3 | | 7 | 1 | 3 | 7 | 1 | 3 | 7 | 1 | 3 | 7 | 1 | 3 | 7 | 1 | 3 | 7 | 1 | 3 | 7 | 1 |
| 21 | 1 | 6 | | 21 | 0 | 3 | 7 | 4 | 3 | 56 | 4 | 18 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 15 | 0 | 1 |
|__________ Сумма младших разрядов произведений = 1+1+6+1+3+7+4+3+6+4+8+5+1 = 50 ________________________________________|
Так как младший разряд суммы равен 0, контрольный ключ рассчитан верно.
simbiat/accountkeying 适用场景与选型建议
simbiat/accountkeying 是一款 基于 PHP 开发的 Composer 扩展包,目前已累计 50 次下载、GitHub Stars 达 0, 最近一次更新时间为 2021 年 01 月 24 日, 在 PHP 生态内属于活跃度较高的组件。
它主要适用于以下技术方向: 「php」 「BIC」 「account」 「Russia」 「keying」 等业务场景。在实际项目中,围绕这些方向常见需要落地的问题包括:接口对接、性能调优、并发安全、与既有框架(Laravel / ThinkPHP / Yii / Webman 等)的兼容适配,以及生产环境的日志埋点与稳定性保障。
我们在过去多个企业项目中使用过 simbiat/accountkeying 或与其功能相近的方案,如果你在选型或落地过程中遇到问题,例如 版本兼容、二次改造、私有化封装、与内部系统对接、生产 BUG 排查,欢迎联系我们协助评估。
基于 simbiat/accountkeying 在你已有业务上做功能扩展、字段裁剪、UI 适配、与内部账号 / 权限 / 日志系统的深度对接。
线上偶发问题、内存泄漏、慢查询、并发异常等排查修复;针对高流量场景做缓存、队列、索引层面的调优。
承接完整的项目从需求 → 设计 → 开发 → 上线 → 长期运维;也可按月提供技术保姆服务。
与 simbiat/accountkeying 相关的其它包
同方向 / 同关键字的高下载量 PHP Composer 包推荐,方便对比选型:
Symfony Simple User Bundle
Symfony integration for Czech bank account library
PHP IBAN - This library provides a converter for account number, bank code and IBAN.
UserBase PHP Client: Identity + Login + Signup Service
A module for Pluf to manage user profiles and user accounts
Account libraries used by Zimbra Api
统计信息
- 总下载量: 50
- 月度下载量: 0
- 日度下载量: 0
- 收藏数: 0
- 点击次数: 11
- 依赖项目数: 0
- 推荐数: 0
其他信息
- 授权协议: AGPL-3.0-or-later
- 更新时间: 2021-01-24