POST已開放bankcard-3-validate

銀行卡三要素驗證

提供銀行卡三要素驗證API服務，便於開發者快速驗證銀行卡三要素相關資訊並整合到業務系統。

接入文件

銀行卡三要素驗證介面說明

銀行卡三要素驗證API用於幫助開發者在系統中快速完成銀行卡三要素驗證相關處理，返回結構化結果，適合實名校驗、准入審核、風控攔截等場景。

適用場景

支援將銀行卡三要素驗證能力接入內部系統、SaaS 平台、自動化工作流或營運後台。
適合需要穩定呼叫、標準化返回和可編排介面能力的業務場景。
建議結合請求頻控、失敗重試和結果快取策略，提升整體接入穩定性。

接入建議

接入前確認請求參數格式、鑑權方式和錯誤碼處理邏輯。
對高頻驗證場景建議做好日誌追蹤、超時控制和冪等處理。
如結果用於風控或自動決策，建議結合業務規則進行二次判斷，而不是直接單點依賴介面返回。

接入示例程式碼

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

請求示例

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

響應示例

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

請求欄位

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

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

響應欄位

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

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

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

import os import requests url = "https://openapi.toolkk.com/v1/bankcard-3-validate" payload = { "name": "张三", "idcard": "110105199003078887", "bankcard": "6228480402564890018" } headers = { "Content-Type": "application/json", "X-API-Key": os.getenv("TOOLKK_API_KEY", "YOUR_API_KEY"), } response = requests.request("POST", url, headers=headers, json=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/bankcard-3-validate" payload := []byte("{\n \"name\": \"张三\",\n \"idcard\": \"110105199003078887\",\n \"bankcard\": \"6228480402564890018\"\n}") req, err := http.NewRequest("POST", 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 \"bankcard\": \"6228480402564890018\"\n}"; HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://openapi.toolkk.com/v1/bankcard-3-validate")) .method("POST", 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/bankcard-3-validate'; $payload = "{\n \"name\": \"张三\",\n \"idcard\": \"110105199003078887\",\n \"bankcard\": \"6228480402564890018\"\n}"; $ch = curl_init($endpoint); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_CUSTOMREQUEST => 'POST', 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;

銀行卡三要素驗證

接入文件