GET已開放bankcard4c-verify

銀行卡四要素核驗

透過姓名、身分證字號、銀行卡號和預留手機號碼四要素，核驗銀行卡資訊的真實性與一致性，有效防範欺詐風險。

接入文件

銀行卡四要素核驗介面

功能介紹

本介面提供銀行卡四要素（姓名、身分證字號、銀行卡號、預留手機號碼）的線上核驗服務。透過此介面，您可以快速、準確地驗證使用者提供的銀行卡資訊是否真實有效，並與對應的身分資訊保持一致。這有助於識別虛假身分和無效銀行卡，大幅提升業務的安全性與合規性。

應用場景

金融借貸: 在使用者申請貸款時，核驗其銀行卡資訊的真實性，防止使用他人或虛假銀行卡進行欺詐。
支付結算: 在使用者綁定銀行卡進行支付或提現前，進行身分與卡片匹配核驗，確保資金流向正確帳戶。
使用者註冊與實名認證: 在註冊環節或要求實名認證的業務中，用於驗證使用者身分與銀行卡資訊的準確性，符合監管要求。
風險控制: 幫助企業建立完善的風控體系，有效識別和攔截潛在的欺詐行為，保護企業和使用者的資產安全。
保險業務: 在投保或理賠過程中，核驗受益人或投保人的銀行卡資訊，確保資金安全。

接入示例程式碼

提供 Shell、Python、Go、Java、PHP 等常見接入示例，便於直接接到現有專案裡。

請求示例

{
  "name": "张三",
  "idcard": "110105199003078887",
  "mobile": "13800138000",
  "bankcard": "6228480402564890018"
}

響應示例

{
  "code": "SUCCESS",
  "message": "success",
  "data": {
    "result": "一致",
    "desc": "姓名/身份证/手机号/银行卡一致"
  }
}

請求欄位

以下欄位根據示例 JSON 自動提取，僅作接入參考。

欄位路徑	型別	示例值
name	string	张三
idcard	string	110105199003078887
mobile	string	13800138000
bankcard	string	6228480402564890018

響應欄位

以下欄位根據示例 JSON 自動提取，僅作接入參考。

欄位路徑	型別	示例值
code	string	SUCCESS
message	string	success
data	object	{...}
data.result	string	一致
data.desc	string	姓名/身份证/手机号/银行卡一致

curl --request GET \ --url 'https://openapi.toolkk.com/v1/bankcard4c-verify' \ --header 'Content-Type: application/json' \ --header 'X-API-Key: YOUR_API_KEY' \ --data '{\n "name": "张三",\n "idcard": "110105199003078887",\n "mobile": "13800138000",\n "bankcard": "6228480402564890018"\n}'

import os import requests url = "https://openapi.toolkk.com/v1/bankcard4c-verify" payload = { "name": "张三", "idcard": "110105199003078887", "mobile": "13800138000", "bankcard": "6228480402564890018" } headers = { "Content-Type": "application/json", "X-API-Key": os.getenv("TOOLKK_API_KEY", "YOUR_API_KEY"), } response = requests.get(url, headers=headers, params=payload, timeout=30) response.raise_for_status() print(response.json())

package main import ( "bytes" "fmt" "io" "net/http" ) func main() { endpoint := "https://openapi.toolkk.com/v1/bankcard4c-verify" payload := []byte("{\n \"name\": \"张三\",\n \"idcard\": \"110105199003078887\",\n \"mobile\": \"13800138000\",\n \"bankcard\": \"6228480402564890018\"\n}") req, err := http.NewRequest("GET", endpoint, bytes.NewBuffer(payload)) if err != nil { panic(err) } req.Header.Set("Content-Type", "application/json") req.Header.Set("X-API-Key", "YOUR_API_KEY") resp, err := http.DefaultClient.Do(req) if err != nil { panic(err) } defer resp.Body.Close() body, err := io.ReadAll(resp.Body) if err != nil { panic(err) } fmt.Println(string(body)) }

import java.net.URI; import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; public class ToolkkExample { public static void main(String[] args) throws Exception { String payload = "{\n \"name\": \"张三\",\n \"idcard\": \"110105199003078887\",\n \"mobile\": \"13800138000\",\n \"bankcard\": \"6228480402564890018\"\n}"; HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://openapi.toolkk.com/v1/bankcard4c-verify")) .method("GET", HttpRequest.BodyPublishers.ofString(payload)) .header("Content-Type", "application/json") .header("X-API-Key", "YOUR_API_KEY") .build(); HttpResponse<String> response = HttpClient.newHttpClient() .send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.body()); } }

<?php $endpoint = 'https://openapi.toolkk.com/v1/bankcard4c-verify'; $payload = "{\n \"name\": \"张三\",\n \"idcard\": \"110105199003078887\",\n \"mobile\": \"13800138000\",\n \"bankcard\": \"6228480402564890018\"\n}"; $ch = curl_init($endpoint); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_CUSTOMREQUEST => 'GET', CURLOPT_HTTPHEADER => [ 'Content-Type: application/json', 'X-API-Key: YOUR_API_KEY', ], CURLOPT_POSTFIELDS => $payload, ]); $response = curl_exec($ch); if ($response === false) { throw new RuntimeException(curl_error($ch)); } curl_close($ch); echo $response;

銀行卡四要素核驗

接入文件