Git Product home page Git Product logo

bankcard's Introduction

bankcard

npm GitHub Build Status

通过银行卡号查询银行卡信息,支持浏览器端和 node 端

安装

npm install bankcard
yarn add bankcard
pnpm add bankcard

使用

  • es
import { searchCardBin } from 'bankcard';
searchCardBin('622305453434432224');
  • node
const { searchCardBin } = require('bankcard');
searchCardBin('622305453434432224');
  • 浏览器引入

在浏览器中使用 script 标签直接引入文件,并使用全局变量 bankcard

npm 包的 bankcard/dist 目录下提供了 bankcard.js 以及 bankcard.min.js。你也可以通过 UNPKG 进行下载。或者在测试中直接使用 UNPKG 线上版本注意版本

<script src="https://unpkg.com/bankcard@latest/dist/bankcard.min.js"></script>
<script>
  bankcard.searchCardBin("622305453434432224");
  bankcard.validateCardInfo("622305453434432224");
</script>

示例

API

type CardInfo = {
  bankName: string; // 银行名称
  bankCode: string; // 银行编码
  cardBin: string; // 银行卡卡Bin
  cardType: CardType; // 卡类型
  cardTypeName: CardTypeName; // 卡类型名称
  len: number; // 卡号长度
};

searchCardBin

根据银行卡号查询卡 Bin 的银行卡信息。

searchCardBin(bankCardNo: string, options?: {
  multiple?: boolean;  // 支持查询多个值,返回结果将变成数组,默认 false 。不常用,仅少数不同银行的卡 bin 存在重复。
  data?: CardInfo[]; // 自定义数据
});

无结果返回 null,有结果返回:CardInfo

multiple=true ,返回:CardInfo[]

validateCardInfo

验证银行卡号。

validateCardInfo(bankCardNo: string, options?: {
  data?: CardInfo[]; // 自定义数据
});

返回:

{
  validated: boolean, // 验证结果
  errorCode: string; // 错误码
  message: string, // 错误信息
  cardInfo: CardInfo | null; // 当验证成功返回 CardInfo ,否则返回 null
}

先查询卡 Bin,再校验卡号长度。如果验证失败 validatedfalse

errorCode message 有以下值:

errorCode message
01 找不到该银行卡号
02 银行卡号格式错误

banks

全部银行列表。

[
  {
    code: 'ABC',
    name: '**农业银行'
  }
  // ...
];

cards

全部银行卡信息列表。

CardInfo[];

CardType

卡类型。

{
  DC: "DC",
  CC: "CC",
  SCC: "SCC",
  PC: "PC"
}

CardTypeName

卡类型名称。

{
  DC: "储蓄卡",
  CC: "信用卡",
  SCC: "准贷记卡",
  PC: "预付费卡"
}

其他

部分银行卡不符合 Luhn 算法。如招商银行的运通卡、**银行借记卡等等。可参阅《支付宝为什么不采用银行卡 Luhn 算法校验卡号?》。

bankcard's People

Contributors

caijf avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.