GETPublicbankcard-check-2

Bank Card 2-Element Verification

Real-time verification of bank card number and cardholder name matching, returning consistent results to aid financial risk control and identity authentication.

Documentation

API Introduction

This API provides a two-factor (name, bank card number) consistency verification service for bank cards. By inputting the user's name and bank card number, the system real-time compares them with bank-reserved information, returning a verification result indicating whether they match. This helps developers quickly confirm the authenticity of user identity information.

Use Cases

Financial Account Opening Review: Verify the cardholder's identity when users bind bank cards or enable payment functions.
E-commerce Withdrawal Risk Control: Ensure ownership of the withdrawal account to prevent fund misappropriation risks.
Corporate Payroll Disbursement: Verify the accuracy of salary card information submitted by employees, reducing payment failure rates.
Credit Application Preliminary Review: Serve as a basic identity verification step to assist in assessing the credibility of applicant data.

Request and Response Description

Request Method: GET
Core Parameters:
name: Cardholder's real name (string)
bankcard: Bank card number to be verified (string)
Return Results:
code: Status code, SUCCESS indicates a successful request.
data.result: Verification conclusion. A value of "Match" indicates that the name and card number match.
data.desc: Result description, such as "Name and bank card number are consistent."

Integration Suggestions

Privacy Compliance: Name and bank card number are sensitive personal information. Ensure HTTPS encryption during transmission and follow relevant laws and regulations for data anonymization and storage.
Error Handling: It is recommended to handle cases where code is not SUCCESS to prevent business interruption due to network fluctuations or temporary upstream service exceptions.
Input Validation: Pre-validate bank card number format (e.g., length, digits only) at the frontend or business layer to reduce invalid requests and optimize cost and performance.

Integration Examples

Includes ready-to-use Shell, Python, Go, Java, and PHP examples for direct integration.

Request Example

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

Response Example

{
  "code": "SUCCESS",
  "message": "success",
  "data": {
    "result": "一致",
    "desc": "姓名与银行卡号一致"
  }
}

Request Fields

The fields below are derived from example JSON for integration reference only.

Path	Type	Sample
name	string	张三
bankcard	string	6228480402564890018

Response Fields

The fields below are derived from example JSON for integration reference only.

Path	Type	Sample
code	string	SUCCESS
message	string	success
data	object	{...}
data.result	string	一致
data.desc	string	姓名与银行卡号一致

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

import os import requests url = "https://openapi.toolkk.com/v1/bankcard-check-2" payload = { "name": "张三", "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/bankcard-check-2" payload := []byte("{\n \"name\": \"张三\",\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 \"bankcard\": \"6228480402564890018\"\n}"; HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://openapi.toolkk.com/v1/bankcard-check-2")) .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/bankcard-check-2'; $payload = "{\n \"name\": \"张三\",\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;

Bank Card 2-Element Verification

Documentation

API Introduction

Use Cases

Request and Response Description

Integration Suggestions

Integration Examples

Request Example

Response Example

Request Fields

Response Fields

Shell Example

Python Example

Go Example

Java Example

PHP Example

Try it online