2025-03-25
- Guides
- API Reference
- Introduction
- Endpoints
- Data Types
- Signing
- 3-D Secure Verification
- Subscription
- Errors
- Webhooks
- Items Information
- Changelog
- Acquiring
- Create a direct paymentPOST
- Create a redirect (iFrame) paymentPOST
- Capture a transactionPOST
- Review a transactionPOST
- Cancel a transactionPOST
- Cancel a subscriptionPOST
- Query a transactionPOST
- Refund a transactionPOST
- Search a refund transactionPOST
- Create a payoutPOST
- Optimise payment methodsPOST
- Update an orderPOST
- Issuing
- Appendix
Query card BIN
POST
https://sandbox.vcc.top/api/card/bin_query
Request
Body Params application/json
request_id
string
optional
<= 100 characters
company_id
number
required
sign
string
required
Encryption Rule: touppercase(SHA256(company_id + api_key))
All encryption parameters need to remove spaces before encryption.
<= 100 characters
Example
{
"request_id": "",
"company_id": "4101",
"sign": "331910C78388B30E0AA2A9CADFC95985CD590C07638B1CE2EDBB7DDA88D2D4F9"
}Request samples
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://sandbox.vcc.top/api/card/bin_query' \
--header 'Content-Type: application/json' \
--data-raw '{
"request_id": "",
"company_id": "4101",
"sign": "331910C78388B30E0AA2A9CADFC95985CD590C07638B1CE2EDBB7DDA88D2D4F9"
}'Responses
🟢200Success
application/json
Body
code
integer
required
msg
object
required
zh-CN
string
required
en-US
string
required
data
array [object {11}]
required
connectorBinId
integer
required
cardBin
string
required
currency
string
required
issueCountry
string
required
cardType
string
required
cardCode
string
required
cardValidPeriod
string
required
issuingBank
null
required
isOneTime
string
required
isHot
string | null
required
status
string
required
Example
{
"code": 0,
"msg": {
"zh-CN": "成功",
"en-US": "Success"
},
"data": [
{
"connectorBinId": 101,
"cardBin": "404038",
"currency": "USD",
"issueCountry": "US",
"cardType": "0",
"cardCode": "Visa",
"cardValidPeriod": "null",
"issuingBank": null,
"isOneTime": "1",
"isHot": null,
"status": "1"
},
{
"connectorBinId": 201,
"cardBin": "428836",
"currency": "USD",
"issueCountry": "US",
"cardType": "0",
"cardCode": "Visa",
"cardValidPeriod": "null",
"issuingBank": null,
"isOneTime": "2",
"isHot": null,
"status": "1"
},
{
"connectorBinId": 301,
"cardBin": "433451",
"currency": "USD",
"issueCountry": "US",
"cardType": "0",
"cardCode": "Visa",
"cardValidPeriod": "null",
"issuingBank": null,
"isOneTime": "1",
"isHot": null,
"status": "1"
},
{
"connectorBinId": 401,
"cardBin": "438357",
"currency": "USD",
"issueCountry": "HK",
"cardType": "0",
"cardCode": "Visa",
"cardValidPeriod": "null",
"issuingBank": null,
"isOneTime": "2",
"isHot": "1",
"status": "1"
},
{
"connectorBinId": 501,
"cardBin": "440872",
"currency": "USD",
"issueCountry": "US",
"cardType": "0",
"cardCode": "Visa",
"cardValidPeriod": "null",
"issuingBank": null,
"isOneTime": "1",
"isHot": null,
"status": "1"
},
{
"connectorBinId": 601,
"cardBin": "441112",
"currency": "USD",
"issueCountry": "US",
"cardType": "0",
"cardCode": "Visa",
"cardValidPeriod": "null",
"issuingBank": null,
"isOneTime": "1",
"isHot": null,
"status": "1"
},
{
"connectorBinId": 701,
"cardBin": "447420",
"currency": "USD",
"issueCountry": "US",
"cardType": "0",
"cardCode": "Visa",
"cardValidPeriod": "null",
"issuingBank": null,
"isOneTime": "1",
"isHot": null,
"status": "1"
},
{
"connectorBinId": 801,
"cardBin": "476715",
"currency": "USD",
"issueCountry": "US",
"cardType": "0",
"cardCode": "Visa",
"cardValidPeriod": "null",
"issuingBank": null,
"isOneTime": "1",
"isHot": null,
"status": "1"
},
{
"connectorBinId": 901,
"cardBin": "483317",
"currency": "USD",
"issueCountry": "US",
"cardType": "0",
"cardCode": "Visa",
"cardValidPeriod": "null",
"issuingBank": null,
"isOneTime": "1",
"isHot": null,
"status": "1"
},
{
"connectorBinId": 1001,
"cardBin": "485997",
"currency": "USD",
"issueCountry": "US",
"cardType": "0",
"cardCode": "Visa",
"cardValidPeriod": "null",
"issuingBank": null,
"isOneTime": "1",
"isHot": null,
"status": "1"
},
{
"connectorBinId": 1101,
"cardBin": "489607",
"currency": "USD",
"issueCountry": "US",
"cardType": "0",
"cardCode": "Visa",
"cardValidPeriod": "null",
"issuingBank": null,
"isOneTime": "1",
"isHot": null,
"status": "1"
},
{
"connectorBinId": 1201,
"cardBin": "491090",
"currency": "USD",
"issueCountry": "US",
"cardType": "0",
"cardCode": "Visa",
"cardValidPeriod": "null",
"issuingBank": null,
"isOneTime": "1",
"isHot": null,
"status": "1"
},
{
"connectorBinId": 1301,
"cardBin": "493193",
"currency": "USD",
"issueCountry": "HK",
"cardType": "0",
"cardCode": "Visa",
"cardValidPeriod": "null",
"issuingBank": null,
"isOneTime": "1",
"isHot": "1",
"status": "1"
},
{
"connectorBinId": 1401,
"cardBin": "519075",
"currency": "USD",
"issueCountry": "US",
"cardType": "0",
"cardCode": "Master",
"cardValidPeriod": "null",
"issuingBank": null,
"isOneTime": "1",
"isHot": null,
"status": "1"
},
{
"connectorBinId": 1501,
"cardBin": "524897",
"currency": "USD",
"issueCountry": "US",
"cardType": "0",
"cardCode": "Master",
"cardValidPeriod": "null",
"issuingBank": null,
"isOneTime": "1",
"isHot": null,
"status": "1"
},
{
"connectorBinId": 1601,
"cardBin": "531993",
"currency": "USD",
"issueCountry": "US",
"cardType": "0",
"cardCode": "Master",
"cardValidPeriod": "null",
"issuingBank": null,
"isOneTime": "1",
"isHot": null,
"status": "1"
},
{
"connectorBinId": 1701,
"cardBin": "534786",
"currency": "USD",
"issueCountry": "US",
"cardType": "0",
"cardCode": "Master",
"cardValidPeriod": "null",
"issuingBank": null,
"isOneTime": "1",
"isHot": null,
"status": "1"
},
{
"connectorBinId": 1801,
"cardBin": "553231",
"currency": "USD",
"issueCountry": "US",
"cardType": "0",
"cardCode": "Master",
"cardValidPeriod": "null",
"issuingBank": null,
"isOneTime": "1",
"isHot": null,
"status": "1"
},
{
"connectorBinId": 1901,
"cardBin": "553370",
"currency": "USD",
"issueCountry": "US",
"cardType": "0",
"cardCode": "Master",
"cardValidPeriod": "null",
"issuingBank": null,
"isOneTime": "1",
"isHot": null,
"status": "1"
},
{
"connectorBinId": 2001,
"cardBin": "553437",
"currency": "USD",
"issueCountry": "US",
"cardType": "0",
"cardCode": "Master",
"cardValidPeriod": "null",
"issuingBank": null,
"isOneTime": "1",
"isHot": null,
"status": "1"
},
{
"connectorBinId": 2101,
"cardBin": "556150",
"currency": "USD",
"issueCountry": "US",
"cardType": "0",
"cardCode": "Master",
"cardValidPeriod": "null",
"issuingBank": null,
"isOneTime": "1",
"isHot": null,
"status": "1"
},
{
"connectorBinId": 2201,
"cardBin": "556167",
"currency": "USD",
"issueCountry": "US",
"cardType": "0",
"cardCode": "Master",
"cardValidPeriod": "null",
"issuingBank": null,
"isOneTime": "1",
"isHot": null,
"status": "1"
},
{
"connectorBinId": 2301,
"cardBin": "556371",
"currency": "USD",
"issueCountry": "US",
"cardType": "0",
"cardCode": "Master",
"cardValidPeriod": "null",
"issuingBank": null,
"isOneTime": "1",
"isHot": null,
"status": "1"
},
{
"connectorBinId": 2401,
"cardBin": "559292",
"currency": "USD",
"issueCountry": "US",
"cardType": "0",
"cardCode": "Master",
"cardValidPeriod": "null",
"issuingBank": null,
"isOneTime": "1",
"isHot": null,
"status": "1"
},
{
"connectorBinId": 2501,
"cardBin": "559666",
"currency": "USD",
"issueCountry": "US",
"cardType": "0",
"cardCode": "Master",
"cardValidPeriod": "null",
"issuingBank": null,
"isOneTime": "1",
"isHot": null,
"status": "1"
},
{
"connectorBinId": 2601,
"cardBin": "52489753",
"currency": "USD",
"issueCountry": "US",
"cardType": "0",
"cardCode": "Master",
"cardValidPeriod": "null",
"issuingBank": null,
"isOneTime": "1",
"isHot": null,
"status": "1"
},
{
"connectorBinId": 2701,
"cardBin": "52489792",
"currency": "USD",
"issueCountry": "US",
"cardType": "0",
"cardCode": "Master",
"cardValidPeriod": "null",
"issuingBank": null,
"isOneTime": "1",
"isHot": null,
"status": "1"
},
{
"connectorBinId": 2801,
"cardBin": "55323173",
"currency": "USD",
"issueCountry": "US",
"cardType": "0",
"cardCode": "Master",
"cardValidPeriod": "null",
"issuingBank": null,
"isOneTime": "1",
"isHot": null,
"status": "1"
},
{
"connectorBinId": 2901,
"cardBin": "55616729",
"currency": "USD",
"issueCountry": "US",
"cardType": "0",
"cardCode": "Master",
"cardValidPeriod": "null",
"issuingBank": null,
"isOneTime": "1",
"isHot": null,
"status": "1"
},
{
"connectorBinId": 3001,
"cardBin": "55616731",
"currency": "USD",
"issueCountry": "US",
"cardType": "0",
"cardCode": "Master",
"cardValidPeriod": "null",
"issuingBank": null,
"isOneTime": "1",
"isHot": null,
"status": "1"
},
{
"connectorBinId": 3101,
"cardBin": "55616764",
"currency": "USD",
"issueCountry": "US",
"cardType": "0",
"cardCode": "Master",
"cardValidPeriod": "null",
"issuingBank": null,
"isOneTime": "1",
"isHot": null,
"status": "1"
}
]
}