完成consumer端同步
This commit is contained in:
295
utils/bankUtils.uts
Normal file
295
utils/bankUtils.uts
Normal file
@@ -0,0 +1,295 @@
|
||||
/**
|
||||
* bankUtils.uts
|
||||
* 银行卡工具集：BIN 识别、OCR 适配、银行列表、表单校验
|
||||
* 所有接口均与真实 OCR 厂商解耦，需接入时只修改 recognizeBankCardFromImage 内部实现
|
||||
*/
|
||||
|
||||
// ─────────────────────────────────────────────
|
||||
// 1. 银行列表数据源
|
||||
// ─────────────────────────────────────────────
|
||||
export type BankItem = {
|
||||
code: string // 内部 code
|
||||
name: string // 银行全称
|
||||
shortName: string // 简称，用于 UI 显示
|
||||
logo: string // 本地 logo 路径（没有则为空串，前端显示占位）
|
||||
}
|
||||
|
||||
export const BANK_LIST: BankItem[] = [
|
||||
{ code: 'ICBC', name: '中国工商银行', shortName: '工商银行', logo: '' },
|
||||
{ code: 'CCB', name: '中国建设银行', shortName: '建设银行', logo: '' },
|
||||
{ code: 'ABC', name: '中国农业银行', shortName: '农业银行', logo: '' },
|
||||
{ code: 'BOC', name: '中国银行', shortName: '中国银行', logo: '' },
|
||||
{ code: 'COMM', name: '交通银行', shortName: '交通银行', logo: '' },
|
||||
{ code: 'CMB', name: '招商银行', shortName: '招商银行', logo: '' },
|
||||
{ code: 'CITIC', name: '中信银行', shortName: '中信银行', logo: '' },
|
||||
{ code: 'SPDB', name: '浦发银行', shortName: '浦发银行', logo: '' },
|
||||
{ code: 'CEB', name: '光大银行', shortName: '光大银行', logo: '' },
|
||||
{ code: 'HXB', name: '华夏银行', shortName: '华夏银行', logo: '' },
|
||||
{ code: 'CMBC', name: '民生银行', shortName: '民生银行', logo: '' },
|
||||
{ code: 'PAB', name: '平安银行', shortName: '平安银行', logo: '' },
|
||||
{ code: 'GDB', name: '广发银行', shortName: '广发银行', logo: '' },
|
||||
{ code: 'BOBJ', name: '北京银行', shortName: '北京银行', logo: '' },
|
||||
{ code: 'SHRCB', name: '上海银行', shortName: '上海银行', logo: '' },
|
||||
{ code: 'PSBC', name: '中国邮政储蓄银行', shortName: '邮储银行', logo: '' },
|
||||
]
|
||||
|
||||
// ─────────────────────────────────────────────
|
||||
// 2. BIN → 银行名称映射（仅 6 位前缀）
|
||||
// 来源：公开 BIN 数据，仅做参考识别用途
|
||||
// ─────────────────────────────────────────────
|
||||
type BinEntry = {
|
||||
prefix: string
|
||||
bankCode: string
|
||||
}
|
||||
|
||||
const BIN_MAP: BinEntry[] = [
|
||||
// 工商银行
|
||||
{ prefix: '6212', bankCode: 'ICBC' },
|
||||
{ prefix: '6216', bankCode: 'ICBC' },
|
||||
{ prefix: '6217', bankCode: 'ICBC' },
|
||||
{ prefix: '6222', bankCode: 'ICBC' },
|
||||
// 建设银行
|
||||
{ prefix: '6217', bankCode: 'CCB' },
|
||||
{ prefix: '6227', bankCode: 'CCB' },
|
||||
{ prefix: '6236', bankCode: 'CCB' },
|
||||
// 农业银行
|
||||
{ prefix: '6225', bankCode: 'ABC' },
|
||||
{ prefix: '6228', bankCode: 'ABC' },
|
||||
{ prefix: '9559', bankCode: 'ABC' },
|
||||
// 中国银行
|
||||
{ prefix: '6013', bankCode: 'BOC' },
|
||||
{ prefix: '6259', bankCode: 'BOC' },
|
||||
{ prefix: '6539', bankCode: 'BOC' },
|
||||
// 交通银行
|
||||
{ prefix: '6222', bankCode: 'COMM' },
|
||||
{ prefix: '6230', bankCode: 'COMM' },
|
||||
{ prefix: '6266', bankCode: 'COMM' },
|
||||
// 招商银行
|
||||
{ prefix: '6214', bankCode: 'CMB' },
|
||||
{ prefix: '6225', bankCode: 'CMB' },
|
||||
{ prefix: '6245', bankCode: 'CMB' },
|
||||
// 中信银行
|
||||
{ prefix: '6217', bankCode: 'CITIC' },
|
||||
{ prefix: '4367', bankCode: 'CITIC' },
|
||||
// 浦发银行
|
||||
{ prefix: '6217', bankCode: 'SPDB' },
|
||||
{ prefix: '6216', bankCode: 'SPDB' },
|
||||
// 平安银行
|
||||
{ prefix: '6214', bankCode: 'PAB' },
|
||||
{ prefix: '6216', bankCode: 'PAB' },
|
||||
// 邮储银行
|
||||
{ prefix: '6210', bankCode: 'PSBC' },
|
||||
{ prefix: '6221', bankCode: 'PSBC' },
|
||||
{ prefix: '6230', bankCode: 'PSBC' },
|
||||
]
|
||||
|
||||
/**
|
||||
* 根据卡号前缀匹配银行（优先匹配最长前缀）
|
||||
* @param cardNo 银行卡号（至少 6 位）
|
||||
* @returns BankItem | null
|
||||
*/
|
||||
export function detectBankByBin(cardNo: string): BankItem | null {
|
||||
const cleaned = cardNo.replace(/\s/g, '')
|
||||
if (cleaned.length < 6) return null
|
||||
const prefix6 = cleaned.substring(0, 6)
|
||||
const prefix4 = cleaned.substring(0, 4)
|
||||
|
||||
// 优先 6 位匹配
|
||||
for (let i = 0; i < BIN_MAP.length; i++) {
|
||||
if (BIN_MAP[i].prefix === prefix6) {
|
||||
return findBankByCode(BIN_MAP[i].bankCode)
|
||||
}
|
||||
}
|
||||
// 降级 4 位匹配
|
||||
for (let i = 0; i < BIN_MAP.length; i++) {
|
||||
if (BIN_MAP[i].prefix === prefix4) {
|
||||
return findBankByCode(BIN_MAP[i].bankCode)
|
||||
}
|
||||
}
|
||||
return null
|
||||
}
|
||||
|
||||
function findBankByCode(code: string): BankItem | null {
|
||||
for (let i = 0; i < BANK_LIST.length; i++) {
|
||||
if (BANK_LIST[i].code === code) return BANK_LIST[i]
|
||||
}
|
||||
return null
|
||||
}
|
||||
|
||||
// ─────────────────────────────────────────────
|
||||
// 3. 银行卡号格式化（每 4 位一空格，仅展示用）
|
||||
// ─────────────────────────────────────────────
|
||||
export function formatCardNo(raw: string): string {
|
||||
const digits = raw.replace(/\D/g, '')
|
||||
let result = ''
|
||||
for (let i = 0; i < digits.length; i++) {
|
||||
if (i > 0 && i % 4 === 0) result += ' '
|
||||
result += digits[i]
|
||||
}
|
||||
return result
|
||||
}
|
||||
|
||||
/** 去除格式化空格，返回纯数字 */
|
||||
export function cleanCardNo(formatted: string): string {
|
||||
return formatted.replace(/\s/g, '')
|
||||
}
|
||||
|
||||
// ─────────────────────────────────────────────
|
||||
// 4. 银行卡号脱敏（验证页展示用）
|
||||
// ─────────────────────────────────────────────
|
||||
export function maskCardNo(cardNo: string): string {
|
||||
const digits = cardNo.replace(/\s/g, '')
|
||||
if (digits.length < 8) return digits
|
||||
const prefix = digits.substring(0, 4)
|
||||
const suffix = digits.substring(digits.length - 4)
|
||||
return prefix + ' **** **** ' + suffix
|
||||
}
|
||||
|
||||
// ─────────────────────────────────────────────
|
||||
// 5. Luhn 校验（可选，建议开启）
|
||||
// ─────────────────────────────────────────────
|
||||
export function luhnCheck(cardNo: string): boolean {
|
||||
const digits = cardNo.replace(/\s/g, '')
|
||||
if (digits.length < 13 || digits.length > 19) return false
|
||||
let sum = 0
|
||||
let alternate = false
|
||||
for (let i = digits.length - 1; i >= 0; i--) {
|
||||
const digitStr = digits.substring(i, i + 1)
|
||||
let n = parseInt(digitStr)
|
||||
if (alternate) {
|
||||
n *= 2
|
||||
if (n > 9) n -= 9
|
||||
}
|
||||
sum += n
|
||||
alternate = !alternate
|
||||
}
|
||||
return sum % 10 === 0
|
||||
}
|
||||
|
||||
// ─────────────────────────────────────────────
|
||||
// 6. 手机号校验
|
||||
// ─────────────────────────────────────────────
|
||||
export function isValidPhone(phone: string): boolean {
|
||||
return /^1[3-9]\d{9}$/.test(phone)
|
||||
}
|
||||
|
||||
// ─────────────────────────────────────────────
|
||||
// 7. OCR 适配层（银行卡识别）
|
||||
// 【接入说明】真实接入时，在此处替换实现：
|
||||
// - 腾讯云：调用 /ocr/v3/BankCardOCR
|
||||
// - 阿里云：调用 /cardrecog/recognize_bank_card
|
||||
// - 自有服务：调用项目后端 OCR 接口
|
||||
// 注意：不要在此硬编码任何 SecretKey / AccessKey
|
||||
// ─────────────────────────────────────────────
|
||||
export type OCRResult = {
|
||||
success: boolean
|
||||
cardNo: string
|
||||
bankName: string // 识别出的银行名称（可能为空）
|
||||
errorMsg: string
|
||||
}
|
||||
|
||||
/**
|
||||
* 选择图片并识别银行卡
|
||||
* 当前为"前端完整流程 + 后端待接入"占位实现
|
||||
* @returns OCRResult
|
||||
*/
|
||||
export async function recognizeBankCardFromImage(): Promise<OCRResult> {
|
||||
return new Promise<OCRResult>((resolve) => {
|
||||
function handleSelectedImage(filePath: string): void {
|
||||
if (filePath === '') {
|
||||
resolve({ success: false, cardNo: '', bankName: '', errorMsg: '未选择图片' } as OCRResult)
|
||||
return
|
||||
}
|
||||
|
||||
console.log('[OCR] 已选择图片:', filePath, '，OCR 服务待接入')
|
||||
resolve({
|
||||
success: false,
|
||||
cardNo: '',
|
||||
bankName: '',
|
||||
errorMsg: 'OCR 服务待接入，请手动输入卡号'
|
||||
} as OCRResult)
|
||||
}
|
||||
|
||||
uni.chooseImage({
|
||||
count: 1,
|
||||
sourceType: ['camera', 'album'],
|
||||
success: (imgRes: ChooseImageSuccess): void => {
|
||||
const filePath = (imgRes.tempFilePaths as string[])[0]
|
||||
try {
|
||||
handleSelectedImage(filePath)
|
||||
} catch (e) {
|
||||
console.error('[OCR] 识别异常:', e)
|
||||
resolve({ success: false, cardNo: '', bankName: '', errorMsg: 'OCR 识别失败' } as OCRResult)
|
||||
}
|
||||
},
|
||||
fail: () => {
|
||||
resolve({ success: false, cardNo: '', bankName: '', errorMsg: '取消选择' } as OCRResult)
|
||||
}
|
||||
})
|
||||
})
|
||||
}
|
||||
|
||||
// ─────────────────────────────────────────────
|
||||
// 8. 短信验证码适配层
|
||||
// 【接入说明】项目后端接入短信服务后，替换此方法
|
||||
// ─────────────────────────────────────────────
|
||||
export type SmsResult = {
|
||||
success: boolean
|
||||
errorMsg: string
|
||||
}
|
||||
|
||||
/**
|
||||
* 发送短信验证码
|
||||
* 当前为占位实现，接入阿里云/腾讯云短信后替换此处
|
||||
* @param phone 11 位手机号
|
||||
*/
|
||||
export async function sendSmsCode(phone: string): Promise<SmsResult> {
|
||||
if (!isValidPhone(phone)) {
|
||||
return { success: false, errorMsg: '手机号格式不正确' } as SmsResult
|
||||
}
|
||||
|
||||
try {
|
||||
// ─── TODO: 接入真实短信服务 ────────────────────────────────
|
||||
// 示例（项目后端代理）：
|
||||
// const res = await uni.request({
|
||||
// url: '/api/sms/send',
|
||||
// method: 'POST',
|
||||
// data: { phone, scene: 'bind_bank_card' }
|
||||
// })
|
||||
// if (res.data.code === 0) return { success: true, errorMsg: '' }
|
||||
// return { success: false, errorMsg: res.data.message }
|
||||
// ─────────────────────────────────────────────────────────
|
||||
|
||||
// 占位实现：模拟发送成功，验证码请查看控制台
|
||||
console.log('[SMS] 占位发送验证码到:', phone, '，模拟验证码: 123456')
|
||||
return { success: true, errorMsg: '' } as SmsResult
|
||||
} catch (e) {
|
||||
console.error('[SMS] 发送异常:', e)
|
||||
return { success: false, errorMsg: '发送失败，请稍后重试' } as SmsResult
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 验证短信验证码
|
||||
* 当前为占位实现：任何 6 位数字均视为通过
|
||||
* @param phone 手机号
|
||||
* @param code 用户输入的验证码
|
||||
*/
|
||||
export async function verifySmsCode(phone: string, code: string): Promise<SmsResult> {
|
||||
if (code.length !== 6) {
|
||||
return { success: false, errorMsg: '请输入 6 位验证码' } as SmsResult
|
||||
}
|
||||
|
||||
try {
|
||||
// ─── TODO: 接入真实验证逻辑 ────────────────────────────────
|
||||
// const res = await uni.request({ ... })
|
||||
// ─────────────────────────────────────────────────────────
|
||||
|
||||
// 占位：校验通过
|
||||
console.log('[SMS] 占位验证通过, phone:', phone, 'code:', code)
|
||||
return { success: true, errorMsg: '' } as SmsResult
|
||||
} catch (e) {
|
||||
console.error('[SMS] 验证异常:', e)
|
||||
return { success: false, errorMsg: '验证失败，请重试' } as SmsResult
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user