Auth Checker

Overview

The Auth Checker validates if a card can be authenticated (added as a payment method) without actually charging it. This is useful for verifying card validity before processing transactions.

Endpoint

POST /v1/checkers/auth

Supported Gateways

Gateway	Status	ID
Stripe	✅ Live	`stripe`
Braintree	✅ Live	`braintree`
Braintree 2	✅ Live	`braintree_2`

Request

Headers

Authorization: YOUR_API_KEY
Content-Type: application/json

Body Parameters

Parameter	Type	Required	Description
`gate`	string	✅	Gateway identifier: `stripe`, `braintree`, `braintree_2`
`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/auth \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "gate": "stripe",
    "cc": "4111111111111111|12|25|123",
    "proxy": "http://user:pass@ip:port"
  }'

Response

Success Response

{
  "success": true,
  "data": {
    "auth": true,
    "live": true,
    "message": "Payment method added successfully",
    "status": null
  }
}

Response Fields

Field	Type	Description
`auth`	boolean	Whether the card was authenticated
`live`	boolean	Whether the card is live
`message`	string	Status message from gateway
`status`	string\|null	Additional status code (for soft declines)

Status Interpretation

`auth`	`live`	Meaning	Credits
`true`	`false`	Card approved/authenticated	5
`false`	`true`	Card is live	3
`false`	`false`	Card is dead/declined	1
Error	-	Technical error	0

Add +1 credit when using system proxy (no proxy provided).

Get Available Gates

List all available auth gates:

GET /v1/checkers/auth/gates

Response:

{
  "success": true,
  "data": {
    "gates": [
      { "id": "stripe", "name": "Stripe Auth" },
      { "id": "braintree", "name": "Braintree Auth" },
      { "id": "braintree_2", "name": "Braintree 2 Auth" }
    ]
  }
}

Error Responses

Invalid Gate

{
  "success": false,
  "data": {
    "error": "Invalid gate"
  }
}

Invalid Card Format

{
  "success": false,
  "data": {
    "error": "Invalid card number format"
  }
}

Proxy Error

{
  "success": false,
  "data": {
    "error": "Proxy is not working or unreachable"
  }
}

Complete Example

async function checkAuth(apiKey, card, gate, proxy) {
  try {
    const response = await fetch("https://api.ender.black/v1/checkers/auth", {
      method: "POST",
      headers: {
        Authorization: apiKey,
        "Content-Type": "application/json",
      },
      body: JSON.stringify({
        gate,
        cc: card,
        proxy,
      }),
    });
 
    const data = await response.json();
 
    if (!data.success) {
      return { status: "error", message: data.data.error };
    }
 
    const { auth, live, message } = data.data;
 
    if (auth) {
      return { status: "approved", message };
    } else if (live) {
      return { status: "live", message };
    } else {
      return { status: "dead", message };
    }
  } catch (error) {
    return { status: "error", message: error.message };
  }
}
 
// Usage
const result = await checkAuth(
  "YOUR_API_KEY",
  "4111111111111111|12|25|123",
  "stripe",
  "http://user:pass@ip:port"
);
 
console.log(result);
// { status: 'approved', message: 'Payment method added successfully' }

Best Practices

Always validate card format before making API calls
Use your own proxies to save 1 credit per check
Handle all response statuses in your application
Implement retry logic for network errors
Rotate proxies to avoid detection

Charge Checker - Actually charge the card
Shopify Checker - Check via Shopify gates
VBV Checker - Check 3D Secure status

Auth Checker

On this page