### 1. 支付安全的“守门人”

在电商结算、信贷放款或第三方支付场景中，**银行卡合规性校验**是资金安全的最后一道闸门。如果将资金打入一张涉及洗钱的“涉案卡”或被标记为“交易欺诈”的账户，企业不仅面临资金损失，更可能触犯反洗钱法规。

**天远银行卡黑名单(实时)接口 (JRZQ0B6Y)** 1 提供了基于多维风险名单库的实时查询能力。它能精准识别卡片是否命中**涉案、不良持卡人、交易欺诈、线下黑名单**等多种高危标签。本文将演示如何使用 Python，通过标准的 AES 加密机制对接该接口，为您的支付系统加上一把“智能锁”。

### 2. API 调用实战：Python 安全对接指南

该接口要求对请求体进行 AES-128-CBC 加密，且每次请求需生成随机 IV（初始化向量），这确保了数据在传输过程中的绝对安全 2。

### 2.1 依赖库准备

推荐使用 `pycryptodome` 库处理加密，`requests` 处理网络请求。

Bash

```jsx
pip install pycryptodome requests
```

### 2.2 完整封装代码

以下代码封装了完整的加解密流程与异常处理，只需替换 `Access-Id` 和 `Access-Key` 即可直接复用。

Python

```jsx
import requests
import json
import base64
import time
from Crypto.Cipher import AES
from Crypto.Util.Padding import pad, unpad
from Crypto.Random import get_random_bytes

class BankCardRiskClient:
    def __init__(self, access_id, access_key_hex):
        # 接口地址：银行卡黑名单(实时)接口
        self.api_url = "https://api.tianyuanapi.com/api/v1/JRZQ0B6Y" # 
        self.access_id = access_id
        self.access_key = bytes.fromhex(access_key_hex) # 16进制转bytes

    def _encrypt(self, plain_dict):
        """AES-CBC 加密：生成随机IV -> 加密 -> 拼接IV -> Base64"""
        iv = get_random_bytes(16) # 
        cipher = AES.new(self.access_key, AES.MODE_CBC, iv)
        
        data_bytes = json.dumps(plain_dict).encode('utf-8')
        # PKCS7 填充
        ciphertext = cipher.encrypt(pad(data_bytes, AES.block_size)) # 
        
        # 拼接 IV 和 密文，转 Base64
        return base64.b64encode(iv + ciphertext).decode('utf-8')

    def _decrypt(self, encrypted_b64):
        """解密：Base64解码 -> 提取IV -> AES解密"""
        try:
            encrypted_bytes = base64.b64decode(encrypted_b64)
            iv = encrypted_bytes[:16] # 提取前16字节作为IV 
            ciphertext = encrypted_bytes[16:]
            
            cipher = AES.new(self.access_key, AES.MODE_CBC, iv)
            decrypted_data = unpad(cipher.decrypt(ciphertext), AES.block_size)
            return json.loads(decrypted_data.decode('utf-8'))
        except Exception as e:
            print(f"解密异常: {e}")
            return None

    def check_card_risk(self, name, id_card, mobile, bank_card):
        # 1. 构造请求参数
        params = {
            "name": name,
            "id_card": id_card,
            "mobile_no": mobile, # "bank_card": bank_card
        }
        
        # 2. 加密参数
        encrypted_data = self._encrypt(params)
        
        # 3. 发送请求
        headers = {"Access-Id": self.access_id}
        payload = {"data": encrypted_data}
        timestamp = int(time.time() * 1000)
        
        try:
            resp = requests.post(f"{self.api_url}?t={timestamp}", headers=headers, json=payload)
            res_json = resp.json()
            
            if res_json.get("code") == 0:
                # 4. 解密响应数据
                return self._decrypt(res_json.get("data"))
            else:
                print(f"API报错: {res_json.get('message')} (Code: {res_json.get('code')})")
                return None
        except Exception as e:
            print(f"网络请求失败: {e}")
            return None

# --- 调用示例 ---
if __name__ == "__main__":
    # 请替换为真实的 Access-Id 和 Hex Key
    client = BankCardRiskClient("YOUR_ID", "YOUR_HEX_KEY")
    
    # 模拟查询
    result = client.check_card_risk(
        name="张三", 
        id_card="11010119900101xxxx", 
        mobile="13800138000", 
        bank_card="622202100111xxxx" # 
    )
    
    if result:
        print("风控检测结果:", json.dumps(result, indent=2, ensure_ascii=False))
```

### 3. 核心数据结构解析

该接口返回的风险标签非常直观，所有字段均采用 **"0" (未命中)** 和 **"1" (命中)** 的形式 。为了便于业务判断，建议将这些字段映射为具体的风险等级。

### 3.1 关键风险字段表

| **字段名** | **含义** | **风险等级** | **业务建议** |
| --- | --- | --- | --- |
| **`caseRelated`** | 命中涉案卡片 | **高危 (S级)** | 该卡涉及案件（如电信诈骗），**绝对禁止**任何资金往来，并上报合规部门。  |
| **`fraudTrans`** | 命中交易欺诈卡片 | **高危 (A级)** | 历史交易存在欺诈行为，建议拦截并冻结账户。  |
| **`badCardHolder`** | 命中不良持卡人 | **中高危 (B级)** | 持卡人信用记录极差，建议人工复审。  |
| **`onlineBlack`** | 命中线上卡号黑名单 | **中危 (C级)** | 存在网络欺诈历史，需限制线上支付额度。  |

### 3.2 响应数据示例

JSON

```jsx
{
  "caseRelated": "0",
  "badCardHolder": "0",
  "fraudTrans": "1",      // 命中! 注意拦截
  "offlineBlack": "0",
  "onlineBlack": "0",
  "otherBlack": "0"
}
```

### 4. 应用价值与场景落地

将该 API 集成到业务流程中，可以显著降低资金损耗。以下是三个典型的落地场景：

### 4.1 绑卡鉴权（四要素 + 黑名单）

在用户首次绑定银行卡时，除了验证“四要素”（姓名、身份证、手机号、卡号）一致性外，必须同步调用本接口。

- **策略**：若 `caseRelated` 或 `fraudTrans` 为 "1"，直接拒绝绑卡请求，提示“卡片状态异常”，防止坏卡进入系统内部。

### 4.2 提现/放款拦截

对于信贷平台的放款环节，这是资金流出的最后一环。

- **策略**：在打款指令发出前 1 秒调用接口。若发现目标卡片近期变成了“涉案卡”（黑名单是实时更新的），立即熔断交易。这能有效避免资金打入诈骗分子账户。

### 4.3 资金归集风控

对于平台型企业，在处理商户提现或资金归集时，需防范商户账户涉及洗钱。

- **策略**：定期扫描商户结算卡，发现 `badCardHolder` 标记时，暂停结算并要求商户提供合规证明。

### 总结

**天远银行卡黑名单 API** 为企业提供了一种低成本（¥2.5/次）且高效的合规手段 。通过 Python 脚本将其无缝嵌入到支付网关或风控中台，您可以构建起一套实时的资金防火墙。

**开发提示**：

- **异常处理**：请务必处理 `1007` (余额不足) 和 `1001` (接口异常) 状态码，确保业务逻辑的健壮性 。
- **数据脱敏**：在日志中打印请求参数时，请对 `bank_card` 和 `id_card` 进行脱敏处理，保障用户隐私安全。


### 对接规范与隐私合规重要提示

在享受天远 API 带来的风控便利时，开发者必须时刻绷紧“安全与合规”这根弦。由于本接口涉及**姓名、身份证号、银行卡号**等高敏感个人信息 ，请务必严格遵守以下规范：

1. **接口对接安全**：
    - **密钥保护**：严禁将 `Access-Id` 和 `Access-Key` 硬编码在前端代码或公开的代码仓库中。请务必存储在服务器端的环境变量或密钥管理服务中。
    - **传输加密**：本接口强制要求使用 HTTPS 加密传输 ，且请求体必须通过 AES-128 算法加密 。请勿尝试绕过加密机制直接发送明文数据，以防止中间人攻击。
2. **个人隐私与合规**：
    - **合法授权**：在调用本接口查询用户黑名单状态前，**必须获得用户的明确授权**。请在您的《隐私政策》或服务协议中明确告知用户，您将使用第三方数据服务进行风险评估。
    - **数据最小化**：仅在业务必要时调用接口。建议对接口返回的敏感结果（如涉案标签）进行脱敏存储，并设置严格的数据访问权限。
    - **合规遵从**：请确保您的业务场景符合《个人信息保护法》及相关反洗钱法规的要求，不得将本接口用于非法的数据买卖或非授权的背景调查。

在电商结算、信贷放款或第三方支付场景中，银行卡合规性校验是资金安全的最后一道闸门。如果将资金打入一张涉及洗钱的“涉案卡”或被标记为“交易欺诈”的账户，企业不仅面临资金损失，更可能触犯反洗钱法规。

Python 对接银行卡黑名单接口：构建支付反欺诈的第一道防线

编程语言

安全

后端

天远银行卡黑名单API提供实时风险检测，精准识别涉案卡、欺诈交易等风险标签。通过Python对接AES加密接口，可快速集成到支付系统，实现绑卡鉴权、放款拦截等风控场景。文章详细讲解API调用流程、加密机制及风险等级划分，帮助企业构建资金安全防火墙。

数据访问权限

数据脱敏

数据结构

密钥管理

服务器

防火墙

Python

JSON

让每一个 Agent，都跑在云上

bigdata-class

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

Python 对接银行卡黑名单接口：构建支付反欺诈的第一道防线-腾讯云开发者社区-腾讯云

Python 对接银行卡黑名单接口：构建支付反欺诈的第一道防线

Python 对接银行卡黑名单接口：构建支付反欺诈的第一道防线

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐