Credit Card Checker

Submit credit card and billing data for fraud risk analysis.

Submit Card Data

POST /checkers/ccard/

Request Body

User Info

Field	Type	Description
user_language	string	Browser language
user_agent	string	Browser user agent
user_ip	string	User IP address
username	string	Username
password_hash	string	Password SHA256 hash

Billing Address

Field	Type	Description
billing_first_name	string	First name
billing_last_name	string	Last name
billing_company	string	Company
billing_country	string	Country name or ISO Alpha-2 (e.g. US)
billing_address_1	string	Street address line 1
billing_address_2	string	Street address line 2
billing_city	string	City
billing_state	string	Region or state
billing_zipcode	string	Postcode or ZIP
billing_phone	string	Phone
billing_email	string	Email

Shipping Address

Field	Type	Description
shipping_first_name	string	First name
shipping_last_name	string	Last name
shipping_company	string	Company
shipping_country	string	Country
shipping_address_1	string	Street address line 1
shipping_address_2	string	Street address line 2
shipping_city	string	City
shipping_state	string	Region or state
shipping_zipcode	string	Postcode or ZIP
shipping_phone	string	Phone
shipping_email	string	Email

Card Details

Field	Type	Description
credit_card_bin	string	First 6 digits of the card (Bank Identification Number)
credit_card_number	string	Full card number
credit_card_expiration_month	string	Expiration month
credit_card_expiration_year	string	Expiration year
avs_code	string	AVS response code
cvv_code	string	CVV response code

Order Details

Field	Type	Description
order_amount	string	Order total amount
order_quantity	string	Number of items
recurring	boolean	Whether this is a recurring/rebilling order
recurring_times	integer	Number of recurring billing cycles
is_expert_check	boolean	Enable expert-level analysis

{
  "user_ip": "1.2.3.4",
  "user_agent": "Mozilla/5.0 ...",
  "billing_first_name": "John",
  "billing_last_name": "Doe",
  "billing_country": "US",
  "billing_email": "john@example.com",
  "credit_card_bin": "411111",
  "credit_card_number": "4111111111111111",
  "credit_card_expiration_month": "12",
  "credit_card_expiration_year": "2026",
  "order_amount": "99.99",
  "order_quantity": "1",
  "recurring": false,
  "is_expert_check": false
}

Get Check Result

GET /checkers/ccard/{id}/

Retrieve the fraud analysis result for a specific task.

Path Parameters

Parameter	Type	Description
id	string (uuid)	Task identifier

Response

{
  "id": "743e5273-70c6-47fa-96cf-9a8f8a9de6de",
  "status": "completed",
  "created_at": "2024-01-15T10:30:00Z",
  "report": "..."
}

Status Values

Status	Description
new	Just created. Not yet processed.
ready_to_perform_audit	Ready to run audit
processing	Waiting for report
completed	Finished (success or failed, details in report)

List All Results

GET /checkers/ccard/

Retrieve all credit card check results for your account.

Query Parameters

Parameter	Type	Description
page	integer	Page number

Example

import time
import requests

API_KEY = "YOUR_API_KEY"
BASE_URL = "https://detect.expert/api/v1"
headers = {"X-Api-Key": API_KEY}

# Submit card data
payload = {
    "user_ip": "1.2.3.4",
    "billing_country": "US",
    "billing_email": "john@example.com",
    "credit_card_bin": "411111",
    "credit_card_number": "4111111111111111",
    "credit_card_expiration_month": "12",
    "credit_card_expiration_year": "2026",
    "order_amount": "99.99",
    "is_expert_check": False,
}
response = requests.post(f"{BASE_URL}/checkers/ccard/", json=payload, headers=headers)
print(response.json())

# Poll for results
task_id = "743e5273-70c6-47fa-96cf-9a8f8a9de6de"
while True:
    result = requests.get(f"{BASE_URL}/checkers/ccard/{task_id}/", headers=headers)
    data = result.json()
    if data["status"] == "completed":
        print(data["report"])
        break
    time.sleep(5)