El Gordo Check API - Documentación

Quick Start

Obtén tu API Key

Contacta al administrador para obtener tu API key. Recibirás una key con formato sk_live_xxxxx

Incluye el header de autenticación

Todas las requests requieren el header X-API-Key con tu API key

Envía tu primera verificación

Usa el endpoint /api/check/simple para verificar tarjetas

Ejemplo rápido - cURL

curl -X POST "https://elgordocheck.online/api/check/simple" \
  -H "X-API-Key: tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{"card_line": "4507990000000010|12|28|123"}'

Autenticación

Todas las requests a la API requieren autenticación mediante API key. Incluye tu key en el header X-API-Key.

⚠️

Importante: Nunca compartas tu API key. Si crees que fue comprometida, contacta al administrador para revocarla.

Headers requeridos

Header	Valor	Descripción
`X-API-Key`	tu_api_key	Tu API key única
`Content-Type`	application/json	Para requests POST

Verificar Tarjeta

POST /api/check/simple

Verifica una tarjeta en formato pipe. Este es el método más simple y recomendado.

Request Body

Campo	Tipo	Requerido	Descripción
`card_line`	string	✅	Tarjeta en formato: `numero\|mes\|año\|cvv`

💡

Formatos aceptados:
• 4507990000000010|12|28|123 (año 2 dígitos)
• 4507990000000010|12|2028|123 (año 4 dígitos)
• 4507990000000010|12/28|123 (separador /)

Request - cURL

curl -X POST "https://elgordocheck.online/api/check/simple" \
  -H "X-API-Key: sk_live_xxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "card_line": "4507990000000010|12|28|123"
  }'

Request - Python

import requests

response = requests.post(
    "https://elgordocheck.online/api/check/simple",
    headers={
        "X-API-Key": "sk_live_xxxxx",
        "Content-Type": "application/json"
    },
    json={
        "card_line": "4507990000000010|12|28|123"
    }
)

result = response.json()
print(result["status"])  # live, dead, sin_fondos, error

Request - JavaScript

const response = await fetch("https://elgordocheck.online/api/check/simple", {
    method: "POST",
    headers: {
        "X-API-Key": "sk_live_xxxxx",
        "Content-Type": "application/json"
    },
    body: JSON.stringify({
        card_line: "4507990000000010|12|28|123"
    })
});

const result = await response.json();
console.log(result.status); // live, dead, sin_fondos, error

Response

                        Response 200 OK
                    

{
    "request_id": "a1b2c3d4",
    "status": "live",
    "message": "APROBADA",
    "card_bin": "450799",
    "card_last4": "0010",
    "time": 3.45,
    "credits_remaining": 95
}
                    

Verificación Masiva

POST /api/check/bulk

Verifica múltiples tarjetas en una sola request (máximo 100 por request).

Request Body

Campo	Tipo	Requerido	Descripción
`cards`	array	✅	Lista de tarjetas en formato pipe
`webhook_url`	string	❌	URL para recibir resultados vía webhook

Request

curl -X POST "https://elgordocheck.online/api/check/bulk" \
  -H "X-API-Key: sk_live_xxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "cards": [
        "4507990000000010|12|28|123",
        "5425233430109903|09|26|456",
        "374245455400126|05|27|1234"
    ],
    "webhook_url": "https://tu-servidor.com/webhook"
  }'

                        Response
                    

{
    "request_id": "bulk_x1y2z3",
    "total": 3,
    "processed": 3,
    "results": [
        {
            "card": "450799****0010",
            "status": "live",
            "message": "APROBADA"
        },
        {
            "card": "542523****9903",
            "status": "dead",
            "message": "DENEGADA"
        },
        {
            "card": "374245****0126",
            "status": "sin_fondos",
            "message": "FONDOS INSUFICIENTES"
        }
    ],
    "credits_remaining": 92
}
                    

Consultar Balance

GET /api/balance

Consulta tus créditos o días restantes según tu plan.

Request

curl "https://elgordocheck.online/api/balance" \
  -H "X-API-Key: sk_live_xxxxx"

                        Response - Plan Tokens
                    

{
    "plan_type": "tokens",
    "credits_remaining": 95,
    "rate_limit": 100,
    "max_bulk": 50
}
                    

                        Response - Plan Monthly
                    

{
    "plan_type": "monthly",
    "days_remaining": 15,
    "expires_at": "2025-12-27T00:00:00",
    "rate_limit": 100,
    "max_bulk": 100
}
                    

Estadísticas

GET /api/stats

Obtén estadísticas de uso de tu API key.

                        Response
                    

{
    "total_checks": 1250,
    "live": 312,
    "dead": 876,
    "sin_fondos": 45,
    "errors": 17,
    "live_rate": "24.96%"
}
                    

Webhooks

POST /api/webhook

Configura una URL de webhook para recibir resultados automáticamente.

Configurar Webhook

curl -X POST "https://elgordocheck.online/api/webhook" \
  -H "X-API-Key: sk_live_xxxxx" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://tu-servidor.com/webhook"}'

Payload del Webhook

Tu servidor recibirá un POST con este formato:

                        Webhook Payload
                    

{
    "request_id": "a1b2c3d4",
    "status": "live",
    "message": "APROBADA",
    "card_bin": "450799",
    "card_last4": "0010",
    "time": 3.45
}
                    

DELETE /api/webhook

Elimina el webhook configurado.

Estados de Respuesta

Status	Descripción	Acción recomendada
live	Tarjeta válida y aprobada	✅ Tarjeta funcional
dead	Tarjeta rechazada o inválida	❌ Descartar tarjeta
sin_fondos	Tarjeta válida pero sin fondos	💳 Tarjeta funcional, sin saldo
error	Error en el proceso de verificación	🔄 Reintentar más tarde

Códigos de Error

Código	Descripción	Solución
`400`	Bad Request - Formato inválido	Verifica el formato de la tarjeta
`401`	Unauthorized - API key inválida	Verifica tu API key
`402`	Payment Required - Sin créditos	Recarga créditos
`429`	Too Many Requests - Rate limit	Espera unos segundos
`500`	Internal Server Error	Contacta soporte

📧

¿Necesitas ayuda?
Contacta al administrador para soporte técnico o para adquirir más créditos.