POSTPublicbankcard-info

Bank Card Location Lookup

Look up bank card numbers to identify the issuing bank, card type, and geographic location. Supports recognition of major bank cards.

Documentation

Features: This API provides a convenient bank card location lookup service. Users simply enter a bank card number to quickly retrieve detailed information, including the issuing bank's name, card type (e.g., debit or credit card), and the issuer's geographic location. The interface supports the recognition of debit and credit cards from major domestic banks, offering high data accuracy and fast response times. It is an ideal choice for finance, payment, and risk control scenarios.

Use Cases:

Financial Risk Control: Verify the authenticity and consistency of bank card information during payments, transfers, and other transactions to effectively reduce transaction risks.
User Experience Optimization: Automatically autofill the bank name when users input their bank card number, reducing manual entry and improving operational convenience.
Marketing & Promotion: Conduct targeted regional marketing campaigns based on the user's bank card location to improve conversion rates.
Data Analysis: Assist in user persona analysis and regional financial data statistics to provide data-driven support for decision-making.

Integration Examples

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

Request Example

{
  "bankcard": "6228480402564890018"
}

Response Example

{
  "code": "SUCCESS",
  "message": "success",
  "data": {
    "bank": "中国农业银行",
    "cardType": "借记卡",
    "cardName": "金穗通宝卡"
  }
}

Request Fields

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

Path	Type	Sample
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.bank	string	中国农业银行
data.cardType	string	借记卡
data.cardName	string	金穗通宝卡

curl --request POST \ --url 'https://openapi.toolkk.com/v1/bankcard-info' \ --header 'Content-Type: application/json' \ --header 'X-API-Key: YOUR_API_KEY' \ --data '{\n "bankcard": "6228480402564890018"\n}'

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

Bank Card Location Lookup

Documentation

Integration Examples

Request Example

Response Example

Request Fields

Response Fields

Shell Example

Python Example

Go Example

Java Example

PHP Example

Try it online