破解按揭联审痛点：从传统人工核查到数据直连
在当今的房地产 O2O 经纪业务中，夫妻共同申请房屋按揭贷款是一个高度标准的流程。由于涉及双方财产共管、家庭负债评估以及首付资金来源的合规性审查，系统对购房者及其配偶的真实身份及关系状态有着严格的要求。传统流程中，中介后台通常依赖购房者人工上传户口本或相关证明扫描件，再由风控专员进行线下核对。这种方式不仅流程繁琐、效率较低，且难以实时防范信息不匹配或伪造资质的风险，极易导致后续贷款审批受阻或引发履约隐患。
通过在 PHP 构建的房产中介后端门户中引入天远双人婚姻评估查询接口，我们能够在获得用户明确授权的前提下，重塑这一审查链路。系统只需传入夫妻双方的姓名与证件号码（即 man_name、man_id_card、woman_name、woman_id_card），即可直连权威数据库进行毫秒级的加密通信。接口解密后将精准返回 state 字段，客观反馈双方当前的真实关系状态（如结婚、匹配不成功、离异等）。这些字段为 O2O 平台在客户购房资质初审阶段提供了客观的数据依据，有效甄别非真实日常账号或资质存疑的联审申请。
将此类合规审查动作无缝嵌入到业务微服务或风控网关中，实现了前置自动化校验与业务的顺畅流转。对于核验一致的用户，系统可自动打通下游按揭审批通道；而对于状态异常的情况，系统可自动触发人工复核提醒。这不仅大幅提升了业务吞吐量，还构建起了一道坚实的信用合规防线。
1. PHP 加密通信集成：构建高可用审核管道
1. 核心参数与加密配置
- 接口地址 :
https://api.tianyuanapi.com/api/v1/IVYZ5E22?t=13位时间戳 - 请求方式 :
POST - 请求头 :
Access-Id: 账号的 Access-Id (必填)Content-Type:application/json
- 关键入参 :
man_name: 男方姓名（必填）man_id_card: 男方证件号码（必填）woman_name: 女方姓名（必填）woman_id_card: 女方证件号码（必填）authorized: 是否取得用户授权（"0":否，"1":是）（必填）
- 鉴权与加密机制 : 使用账户的 16 进制 Access Key 作为密钥，采用 AES-128 算法的 CBC 模式。每次请求需动态生成 16 字节的 IV（初始化向量），并配合 PKCS7 填充，最终将 IV 与密文拼接后进行 Base64 编码放入请求体
data字段中。
2. 标准化调用代码 (PHP)
php
<?php
class MarriageAssessmentClient {
private $accessId;
private $accessKey;
private $baseUrl;
public function __construct($accessId, $accessKey, $baseUrl = "https://api.tianyuanapi.com") {
$this->accessId = $accessId;
// 若接入密钥为 16 进制字符串 (32 字符)，需转换为二进制
$this->accessKey = strlen($accessKey) === 32 ? hex2bin($accessKey) : $accessKey;
$this->baseUrl = $baseUrl;
}
public function encrypt($data) {
$iv = openssl_random_pseudo_bytes(16);
// OpenSSL 默认使用 PKCS7 填充
$encrypted = openssl_encrypt(json_encode($data, JSON_UNESCAPED_UNICODE), 'aes-128-cbc', $this->accessKey, OPENSSL_RAW_DATA, $iv);
return base64_encode($iv . $encrypted);
}
public function decrypt($base64Data) {
$decoded = base64_decode($base64Data);
$iv = substr($decoded, 0, 16);
$encrypted = substr($decoded, 16);
$decrypted = openssl_decrypt($encrypted, 'aes-128-cbc', $this->accessKey, OPENSSL_RAW_DATA, $iv);
return json_decode($decrypted, true);
}
public function checkStatus($params) {
$timestamp = (int)(microtime(true) * 1000);
$url = $this->baseUrl . "/api/v1/IVYZ5E22?t=" . $timestamp;
$payload = json_encode([
'data' => $this->encrypt($params)
]);
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Content-Type: application/json',
'Access-Id: ' . $this->accessId
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
$result = json_decode($response, true);
if (isset($result['data']) && is_string($result['data'])) {
$result['data'] = $this->decrypt($result['data']);
}
return $result;
}
}
// 实例化并调用
$client = new MarriageAssessmentClient("your_access_id", "your_hex_access_key");
$params = [
"man_name" => "张三",
"man_id_card" => "110105199001011234",
"woman_name" => "李四",
"woman_id_card" => "110105199201011234",
"authorized" => "1"
];
$result = $client->checkStatus($params);
print_r($result);
?>3. 终端快捷验证 (cURL)
bash
# 生成加密 payload 后，可通过以下 cURL 进行接口连通性测试
curl -X POST "https://api.tianyuanapi.com/api/v1/IVYZ5E22?t=1693440000000" \
-H "Content-Type: application/json" \
-H "Access-Id: your_access_id" \
-d '{"data": "base64_encoded_iv_and_encrypted_payload"}'2. 核心状态数据解析与业务映射
以下为解密后返回的关键状态字段解析，该字段对于资质审核至关重要：
| 字段名 | 类型 | 说明 | 业务映射建议 |
|---|---|---|---|
state |
string | 1:结婚，2:匹配不成功，3:离异 | 直接作为是否允许推进共同按揭流程的关键判断依据。 |
技术提示 ：在保存日志或缓存响应数据时，请务必对身份证件号码等敏感 PII 信息进行脱敏处理（例如：
110105********1234），严格遵守数据安全合规要求。
3. 场景化应用：让核验数据赋能合规闭环
在 PHP 搭建的房产 O2O 平台业务链路中，该接口可支持多种场景的落地闭环：
- 夫妻按揭联保资质预审 ：在购房者提交共同还款申请时，后台系统自动调用接口比对填报信息。若返回状态
1:结婚，系统即自动通过预审节点，释放购房者前往下一步上传收入证明，减少等待摩擦。 - 共有产权登记资格排查 ：在房产过户备案前的合规审查环节中，若接口返回
2:匹配不成功或3:离异，系统立即执行前置准入校验，暂停自动化合同生成流程，并触发人工复核提醒，引导客户更新或补充最新资质证明，避免由于信息偏差带来的确权纠纷。
4. 生产环境接入的安全与合规边界
- 隐私授权边界 ：在提交任何查验请求前，务必在前端页面通过弹窗或签署《隐私授权协议》明确告知用户用途，并确保入参
authorized为"1"。 - 密文传输存储：生产环境中的通信全程应依赖 HTTPS；在内部数据库落地时，对于解密后的身份信息应实施二次加密存储，切忌明文落盘。
- 限流控制策略：为保证风控网关的高可用，应在 PHP 中间件层设计基于 Access-Id 或客户端 IP 的滑动窗口限流机制，避免接口层遭遇瞬时高并发带来的稳定性风险。