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 APM paymentPOST
- Create a redirect (iFrame) paymentPOST
- Query a transactionPOST
- Capture a transactionPOST
- Review a transactionPOST
- Cancel a transactionPOST
- Cancel a subscriptionPOST
- Refund a transactionPOST
- Search a refund transactionPOST
- Create a payoutPOST
- Optimise payment methodsPOST
- Issuing
- Cardholder
- Group
- Card
- Appendix
Query card BIN
POST
https://sandbox.vcc.top/api/card/bin_query
Request
Body Params application/json
Example
{
"company_id": "{{companyId}}",
"sign": "{{sign}}"
}Request Code 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 '{
"company_id": "{{companyId}}",
"sign": "{{sign}}"
}'Responses
🟢200Success
application/json
Body
Example
{
"code": "0000",
"message": "Success",
"result": [
{
"currency": "USD",
"status": "1",
"card_bin_id": 101,
"card_bin": "404038",
"issue_country_code": "US",
"card_brand": "Visa",
"card_type": "0",
"usage_type": "2",
"channel_code": "002",
"enable_apple_pay": "0",
"is_hot": "0"
},
{
"currency": "USD",
"status": "1",
"card_bin_id": 201,
"card_bin": "428836",
"issue_country_code": "US",
"card_brand": "Visa",
"card_type": "0",
"usage_type": "2",
"channel_code": "002",
"enable_apple_pay": "0",
"is_hot": "0"
},
{
"currency": "USD",
"status": "1",
"card_bin_id": 301,
"card_bin": "433451",
"issue_country_code": "US",
"card_brand": "Visa",
"card_type": "0",
"usage_type": "1",
"channel_code": "002",
"enable_apple_pay": "0",
"is_hot": "0"
},
{
"currency": "USD",
"status": "1",
"card_bin_id": 401,
"card_bin": "438357",
"issue_country_code": "HK",
"card_brand": "Visa",
"card_type": "0",
"usage_type": "2",
"channel_code": "002",
"enable_apple_pay": "0",
"is_hot": "1"
},
{
"currency": "USD",
"status": "1",
"card_bin_id": 501,
"card_bin": "440872",
"issue_country_code": "US",
"card_brand": "Visa",
"card_type": "0",
"usage_type": "1",
"channel_code": "002",
"enable_apple_pay": "0",
"is_hot": "0"
},
{
"currency": "USD",
"status": "1",
"card_bin_id": 601,
"card_bin": "441112",
"issue_country_code": "US",
"card_brand": "Visa",
"card_type": "0",
"usage_type": "1",
"channel_code": "002",
"enable_apple_pay": "0",
"is_hot": "0"
},
{
"currency": "USD",
"status": "1",
"card_bin_id": 701,
"card_bin": "447420",
"issue_country_code": "US",
"card_brand": "Visa",
"card_type": "0",
"usage_type": "1",
"channel_code": "002",
"enable_apple_pay": "0",
"is_hot": "0"
},
{
"currency": "USD",
"status": "1",
"card_bin_id": 801,
"card_bin": "476715",
"issue_country_code": "US",
"card_brand": "Visa",
"card_type": "0",
"usage_type": "1",
"channel_code": "002",
"enable_apple_pay": "0",
"is_hot": "0"
},
{
"currency": "USD",
"status": "1",
"card_bin_id": 901,
"card_bin": "483317",
"issue_country_code": "US",
"card_brand": "Visa",
"card_type": "0",
"usage_type": "1",
"channel_code": "002",
"enable_apple_pay": "0",
"is_hot": "0"
},
{
"currency": "USD",
"status": "1",
"card_bin_id": 1001,
"card_bin": "485997",
"issue_country_code": "US",
"card_brand": "Visa",
"card_type": "0",
"usage_type": "1",
"channel_code": "002",
"enable_apple_pay": "0",
"is_hot": "0"
},
{
"currency": "USD",
"status": "1",
"card_bin_id": 1101,
"card_bin": "489607",
"issue_country_code": "US",
"card_brand": "Visa",
"card_type": "0",
"usage_type": "1",
"channel_code": "002",
"enable_apple_pay": "0",
"is_hot": "0"
},
{
"currency": "USD",
"status": "1",
"card_bin_id": 1201,
"card_bin": "491090",
"issue_country_code": "US",
"card_brand": "Visa",
"card_type": "0",
"usage_type": "1",
"channel_code": "002",
"enable_apple_pay": "0",
"is_hot": "0"
},
{
"currency": "USD",
"status": "1",
"card_bin_id": 1301,
"card_bin": "493193",
"issue_country_code": "HK",
"card_brand": "Visa",
"card_type": "0",
"usage_type": "1",
"channel_code": "002",
"enable_apple_pay": "0",
"is_hot": "1"
},
{
"currency": "USD",
"status": "1",
"card_bin_id": 1401,
"card_bin": "519075",
"issue_country_code": "US",
"card_brand": "MasterCard",
"card_type": "0",
"usage_type": "1",
"channel_code": "002",
"enable_apple_pay": "0",
"is_hot": "0"
},
{
"currency": "USD",
"status": "1",
"card_bin_id": 1501,
"card_bin": "524897",
"issue_country_code": "US",
"card_brand": "MasterCard",
"card_type": "0",
"usage_type": "1",
"channel_code": "002",
"enable_apple_pay": "0",
"is_hot": "0"
},
{
"currency": "USD",
"status": "1",
"card_bin_id": 1601,
"card_bin": "531993",
"issue_country_code": "US",
"card_brand": "MasterCard",
"card_type": "0",
"usage_type": "1",
"channel_code": "002",
"enable_apple_pay": "0",
"is_hot": "0"
},
{
"currency": "USD",
"status": "1",
"card_bin_id": 1701,
"card_bin": "534786",
"issue_country_code": "US",
"card_brand": "MasterCard",
"card_type": "0",
"usage_type": "1",
"channel_code": "002",
"enable_apple_pay": "0",
"is_hot": "0"
},
{
"currency": "USD",
"status": "1",
"card_bin_id": 1801,
"card_bin": "553231",
"issue_country_code": "US",
"card_brand": "MasterCard",
"card_type": "0",
"usage_type": "1",
"channel_code": "002",
"enable_apple_pay": "0",
"is_hot": "0"
},
{
"currency": "USD",
"status": "1",
"card_bin_id": 1901,
"card_bin": "553370",
"issue_country_code": "US",
"card_brand": "MasterCard",
"card_type": "0",
"usage_type": "1",
"channel_code": "002",
"enable_apple_pay": "0",
"is_hot": "0"
},
{
"currency": "USD",
"status": "1",
"card_bin_id": 2001,
"card_bin": "553437",
"issue_country_code": "US",
"card_brand": "MasterCard",
"card_type": "0",
"usage_type": "1",
"channel_code": "002",
"enable_apple_pay": "0",
"is_hot": "0"
},
{
"currency": "USD",
"status": "1",
"card_bin_id": 2101,
"card_bin": "556150",
"issue_country_code": "US",
"card_brand": "MasterCard",
"card_type": "0",
"usage_type": "1",
"channel_code": "002",
"enable_apple_pay": "0",
"is_hot": "0"
},
{
"currency": "USD",
"status": "1",
"card_bin_id": 2201,
"card_bin": "556167",
"issue_country_code": "US",
"card_brand": "MasterCard",
"card_type": "0",
"usage_type": "1",
"channel_code": "002",
"enable_apple_pay": "0",
"is_hot": "0"
},
{
"currency": "USD",
"status": "1",
"card_bin_id": 2301,
"card_bin": "556371",
"issue_country_code": "US",
"card_brand": "MasterCard",
"card_type": "0",
"usage_type": "1",
"channel_code": "002",
"enable_apple_pay": "0",
"is_hot": "0"
},
{
"currency": "USD",
"status": "1",
"card_bin_id": 2401,
"card_bin": "559292",
"issue_country_code": "US",
"card_brand": "MasterCard",
"card_type": "0",
"usage_type": "1",
"channel_code": "002",
"enable_apple_pay": "0",
"is_hot": "0"
},
{
"currency": "USD",
"status": "1",
"card_bin_id": 2501,
"card_bin": "559666",
"issue_country_code": "US",
"card_brand": "MasterCard",
"card_type": "0",
"usage_type": "1",
"channel_code": "002",
"enable_apple_pay": "0",
"is_hot": "0"
},
{
"currency": "USD",
"status": "1",
"card_bin_id": 2601,
"card_bin": "52489753",
"issue_country_code": "US",
"card_brand": "MasterCard",
"card_type": "0",
"usage_type": "1",
"channel_code": "002",
"enable_apple_pay": "0",
"is_hot": "0"
},
{
"currency": "USD",
"status": "1",
"card_bin_id": 2701,
"card_bin": "52489792",
"issue_country_code": "US",
"card_brand": "MasterCard",
"card_type": "0",
"usage_type": "1",
"channel_code": "002",
"enable_apple_pay": "0",
"is_hot": "0"
},
{
"currency": "USD",
"status": "1",
"card_bin_id": 2801,
"card_bin": "55323173",
"issue_country_code": "US",
"card_brand": "MasterCard",
"card_type": "0",
"usage_type": "1",
"channel_code": "002",
"enable_apple_pay": "0",
"is_hot": "0"
},
{
"currency": "USD",
"status": "1",
"card_bin_id": 2901,
"card_bin": "55616729",
"issue_country_code": "US",
"card_brand": "MasterCard",
"card_type": "0",
"usage_type": "1",
"channel_code": "002",
"enable_apple_pay": "0",
"is_hot": "0"
},
{
"currency": "USD",
"status": "1",
"card_bin_id": 3001,
"card_bin": "55616731",
"issue_country_code": "US",
"card_brand": "MasterCard",
"card_type": "0",
"usage_type": "1",
"channel_code": "002",
"enable_apple_pay": "0",
"is_hot": "0"
},
{
"currency": "USD",
"status": "1",
"card_bin_id": 3101,
"card_bin": "55616764",
"issue_country_code": "US",
"card_brand": "MasterCard",
"card_type": "0",
"usage_type": "1",
"channel_code": "002",
"enable_apple_pay": "0",
"is_hot": "0"
},
{
"currency": "USD",
"status": "1",
"card_bin_id": 4801,
"card_bin": "404045",
"issue_country_code": "US",
"card_brand": "VISA",
"card_type": "1",
"usage_type": "1",
"channel_code": "003",
"enable_apple_pay": "0",
"is_hot": "1"
},
{
"currency": "USD",
"status": "1",
"card_bin_id": 4901,
"card_bin": "466346",
"issue_country_code": "US",
"card_brand": "VISA",
"card_type": "1",
"usage_type": "1",
"channel_code": "003",
"enable_apple_pay": "0",
"is_hot": "1"
},
{
"currency": "USD",
"status": "1",
"card_bin_id": 5001,
"card_bin": "******",
"issue_country_code": "US",
"card_brand": "VISA",
"card_type": "1",
"usage_type": "1",
"channel_code": "001",
"enable_apple_pay": "1",
"is_hot": "1"
},
{
"currency": "USD",
"status": "1",
"card_bin_id": 5101,
"card_bin": "******",
"issue_country_code": "US",
"card_brand": "VISA",
"card_type": "1",
"usage_type": "1",
"channel_code": "009",
"enable_apple_pay": "0",
"is_hot": "1"
},
{
"currency": "USD",
"status": "1",
"card_bin_id": 5701,
"card_bin": "522981",
"issue_country_code": "US",
"card_brand": "MasterCard",
"card_type": "1",
"usage_type": "1",
"channel_code": "004",
"enable_apple_pay": "0",
"is_hot": "1"
},
{
"currency": "USD",
"status": "1",
"card_bin_id": 5801,
"card_bin": "553437",
"issue_country_code": "US",
"card_brand": "MasterCard",
"card_type": "1",
"usage_type": "1",
"channel_code": "004",
"enable_apple_pay": "0",
"is_hot": "1"
},
{
"currency": "USD",
"status": "1",
"card_bin_id": 5901,
"card_bin": "658706",
"issue_country_code": "US",
"card_brand": "VISA",
"card_type": "1",
"usage_type": "1",
"channel_code": "004",
"enable_apple_pay": "0",
"is_hot": "1"
},
{
"currency": "USD",
"status": "1",
"card_bin_id": 6001,
"card_bin": "111111",
"issue_country_code": "US",
"card_brand": "VISA",
"card_type": "1",
"usage_type": "1",
"channel_code": "004",
"enable_apple_pay": "0",
"is_hot": "1"
},
{
"currency": "USD",
"status": "1",
"card_bin_id": 6301,
"card_bin": "404038",
"issue_country_code": "US",
"card_brand": "VISA",
"card_type": "1",
"usage_type": "1",
"channel_code": "009",
"enable_apple_pay": "0",
"is_hot": "1"
},
{
"currency": "USD",
"status": "1",
"card_bin_id": 6401,
"card_bin": "54502000",
"issue_country_code": "US",
"card_brand": "MasterCard",
"card_type": "1",
"usage_type": "1",
"channel_code": "004",
"enable_apple_pay": "0",
"is_hot": "1"
},
{
"currency": "USD",
"status": "1",
"card_bin_id": 6501,
"card_bin": "558325",
"issue_country_code": "US",
"card_brand": "MasterCard",
"card_type": "1",
"usage_type": "1",
"channel_code": "004",
"enable_apple_pay": "0",
"is_hot": "1"
},
{
"currency": "USD",
"status": "1",
"card_bin_id": 6701,
"card_bin": "436120",
"issue_country_code": "US",
"card_brand": "VISA",
"card_type": "1",
"usage_type": "1",
"channel_code": "006",
"enable_apple_pay": "0",
"is_hot": "1"
},
{
"currency": "USD",
"status": "1",
"card_bin_id": 9701,
"card_bin": "404038",
"issue_country_code": "US",
"card_brand": "Visa",
"card_type": "0",
"usage_type": "1",
"channel_code": "008",
"enable_apple_pay": "0",
"is_hot": ""
},
{
"currency": "USD",
"status": "1",
"card_bin_id": 9801,
"card_bin": "******",
"issue_country_code": "HK",
"card_brand": "MasterCard",
"card_type": "0",
"usage_type": "1",
"channel_code": "013",
"enable_apple_pay": "0",
"is_hot": ""
}
]
}