bank-info-indentify
UnionPay Card Account Type Checker
UnionPay Card Account Type Checker
Usage Cost
250 coins/call
Quick Start
Use a unified response envelope and call directly from your backend.
https://openapi.toolkk.com/v1/bank-info-indentifycURL Example
curl --request POST \
--url 'https://openapi.toolkk.com/v1/bank-info-indentify' \
--header 'Content-Type: application/json' \
--header 'X-API-Key: YOUR_API_KEY' \
--data '{\n "bankcard": ""\n}'Python Example
import os
import requests
url = "https://openapi.toolkk.com/v1/bank-info-indentify"
payload = {
"bankcard": ""
}
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())Go Example
package main
import (
"bytes"
"fmt"
"io"
"net/http"
)
func main() {
endpoint := "https://openapi.toolkk.com/v1/bank-info-indentify"
payload := []byte("{\n \"bankcard\": \"\"\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))
}Java Example
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\": \"\"\n}";
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://openapi.toolkk.com/v1/bank-info-indentify"))
.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 Example
<?php
$endpoint = 'https://openapi.toolkk.com/v1/bank-info-indentify';
$payload = "{\n \"bankcard\": \"\"\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;Response Example
{
"msg": "成功",
"success": true,
"code": 200,
"data": {
"result": "1",
"orderNo": "202511282209035161761",
"resultMsg": "Ⅰ类"
}
}Examples illustrate the response structure. Actual results depend on the API response.
- Authentication
- Send X-API-Key in request headers
- Rate limit
- 60 req/min
- Timeout
- 5000 ms
Send your API Key in the X-API-Key header from your backend.
Check both HTTP status and business fields before treating a call as successful.
Use retries and backoff together with rate limits in high-frequency scenarios.
Request Fields
Send requests from your server with the key in the X-API-Key header.
Request Fields
Fields are read from the API schema. Missing descriptions and examples are marked as unspecified.
| Path | Type | Required | Description | Sample |
|---|---|---|---|---|
| bankcard | string | Yes | Unspecified | Unspecified |
Request Example
{
"bankcard": ""
}- Authentication
- Send X-API-Key in request headers
- Rate limit
- 60 req/min
- Timeout
- 5000 ms
Response Fields
Examples illustrate the response structure. Actual results depend on the API response.
Response Fields
Fields are read from the API schema. Missing descriptions and examples are marked as unspecified.
| Path | Type | Required | Description | Sample |
|---|---|---|---|---|
| msg | string | No | Unspecified | 成功 |
| success | boolean | No | Unspecified | true |
| code | number | No | Unspecified | 200 |
| data | object | No | Unspecified | Unspecified |
| data.result | string | No | Unspecified | 1 |
| data.orderNo | string | No | Unspecified | 202511282209035161761 |
| data.resultMsg | string | No | Unspecified | Ⅰ类 |
Response Example
{
"msg": "成功",
"success": true,
"code": 200,
"data": {
"result": "1",
"orderNo": "202511282209035161761",
"resultMsg": "Ⅰ类"
}
}API overview
Capabilities, use cases, limitations, and frequently asked questions.
API Overview
This API provides UnionPay card account type identification services. By providing a bank card number, the system returns the corresponding account tier for that card (e.g., Class I, Class II, or Class III accounts), helping developers distinguish between full-feature accounts and restricted-feature accounts.
Use Cases
- Financial Risk Control: Verify account permissions before opening an account or making a transfer to prevent illicit transactions.
- Business Diversion: Guide users to different top-up or payment operations based on account type and associated limits.
- Data Cleansing: Enhance user profiles by marking valid high-privilege bank accounts.
Request and Response Details
- Request Method: POST
- Core Parameter:
bankcard(string, required), the UnionPay card number to be queried. - Response Result: JSON format. When
successis true, thedata.resultMsgfield contains a specific type description (e.g., “Class I”), and is the type code.