VBV Checker

Check if a credit card requires 3D Secure (VBV/Mastercard SecureCode) authentication.

Overview

The VBV Checker determines if a card requires 3D Secure authentication (Verified by Visa, Mastercard SecureCode, etc.). This is useful for identifying cards that can be used without additional authentication steps.

VBV stands for "Verified by Visa" - the 3D Secure implementation for Visa cards. This checker works for all card brands with 3D Secure.

Endpoint

POST /v1/checkers/vbv

Supported Gates

Gateway	Status	ID
Braintree	✅ Live	`braintree`

Request

Headers

Authorization: YOUR_API_KEY
Content-Type: application/json

Body Parameters

Parameter	Type	Required	Description
`gate`	string	✅	Gateway identifier: `braintree`
`cc`	string	✅	Card in format: `number\|mm\|yy\|cvv`
`proxy`	string	❌	Proxy URL (system proxy used if omitted)

Example Request

curl -X POST https://api.ender.black/v1/checkers/vbv \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "gate": "braintree",
    "cc": "4111111111111111|12|25|123",
    "proxy": "http://user:pass@ip:port"
  }'

Response

Success Response

{
  "success": true,
  "data": {
    "status": "authenticate_successful",
    "non_vbv": true,
    "enrolled": "Y",
    "lookup_status": true,
    "lookup_status_reason": null,
    "authentication_status": true,
    "authentication_status_reason": null
  }
}

Response Fields

Field	Type	Description
`status`	string	3D Secure status
`non_vbv`	boolean	`true` if card doesn't require 3DS
`enrolled`	string	Enrollment status: `Y`, `N`, or `U`
`lookup_status`	boolean\|null	Lookup transaction status
`lookup_status_reason`	string\|null	Reason for lookup status
`authentication_status`	boolean\|null	Authentication status
`authentication_status_reason`	string\|null	Reason for auth status

Understanding Results

Enrollment Status

Value	Meaning
`Y`	Card is enrolled in 3D Secure
`N`	Card is NOT enrolled in 3D Secure
`U`	Enrollment status unknown

Non-VBV Interpretation

`non_vbv`	`enrolled`	Meaning
`true`	`N`	Card does NOT require 3DS ✅
`false`	`Y`	Card requires 3DS authentication
-	`U`	Unable to determine

Cards with non_vbv: true can be used without additional authentication challenges.

Credit Costs

The VBV checker has a flat rate regardless of result:

Result	User Proxy	System Proxy
Any result	2 credits	3 credits
Error	0 credits	0 credits

Get Available Gates

GET /v1/checkers/vbv/gates

Response:

{
  "success": true,
  "data": {
    "gates": [{ "id": "braintree", "name": "Braintree VBV" }]
  }
}

Complete Example

async function checkVBV(apiKey, card, gate, proxy) {
  try {
    const body = {
      gate,
      cc: card,
    };
 
    if (proxy) body.proxy = proxy;
 
    const response = await fetch("https://api.ender.black/v1/checkers/vbv", {
      method: "POST",
      headers: {
        Authorization: apiKey,
        "Content-Type": "application/json",
      },
      body: JSON.stringify(body),
    });
 
    const data = await response.json();
 
    if (!data.success) {
      return {
        status: "error",
        message: data.data.error,
      };
    }
 
    const { non_vbv, enrolled, status } = data.data;
 
    return {
      isNonVBV: non_vbv,
      enrolled,
      status,
      message: non_vbv
        ? "Card does not require 3D Secure"
        : "Card requires 3D Secure authentication",
    };
  } catch (error) {
    return { status: "error", message: error.message };
  }
}
 
// Usage
const result = await checkVBV(
  "YOUR_API_KEY",
  "4111111111111111|12|25|123",
  "braintree",
  "http://user:pass@ip:port"
);
 
console.log(result);
// { isNonVBV: true, enrolled: 'N', status: 'authenticate_successful', message: 'Card does not require 3D Secure' }

Common Status Values

Status	Description
`authenticate_successful`	Authentication lookup successful
`authenticate_failed`	Authentication failed
`authenticate_unable_to_authenticate`	Could not authenticate
`authenticate_rejected`	Authentication rejected
`lookup_error`	Error during lookup

Use Cases

Pre-filter cards - Identify non-VBV cards before processing
Risk assessment - 3DS-enrolled cards have lower fraud risk
Flow optimization - Route non-VBV cards to simpler checkout flows
Compliance - Ensure 3DS is used when required

Best Practices

Use with other checkers - Combine VBV check with auth/charge for complete validation
Cache results - VBV status rarely changes for a given card
Handle unknown status - Treat U enrollment as requiring 3DS

Auth Checker - Validate card authentication
Charge Checker - Process actual charges
Shopify Checker - Shopify-based validation

VBV Checker

On this page