API v1.0 — Stable

NigthwingChk
APIs Docs

Sistema de renta de gates por creditos a nivel global jeje xd.

Overview

Flujo de la API

La sesiĂłn se mantiene activa hasta completar el paso 7 o detenerse en validaciones. Sin expiraciĂłn por tiempo.

1

Init Session

Envías tu api_key → recibes session_id

POST /session/init
2

Auth Token

Envías session_id → recibes token cifrado Base64

POST /session/auth
3

Submit Gate

EnvĂ­as gate + card + token decodificado

POST /gate/submit
4

Luhn Validation

Automático — si falla, sesión termina sin cobrar créditos

AUTO
5

BIN Check

Verifica BIN baneado — si está baneado, sesión termina sin cobrar

AUTO
6

Processing

Polling cada 3-5s hasta obtener resultado

POST /gate/status
7

Result

Resultado final — sesión expira, créditos descontados

POST /gate/result
Paso 1

Init Session

Inicia una sesión enviando tu api_key. Recibirás un session_id para continuar al paso 2.

ParámetroTipoRequeridoDescripción
api_keystringSI ✔Clave de acceso — formato nw_xxxxxxxx
Request
POST /session/init
POST https://renta.nigthwingchkweb.com/api/session/init
Content-Type: application/json

{
  "api_key": "nw_xxxxxxxxxxxxxxxx"
}
Response
200 OK
{
  "status": true,
  "session_id": "ses_a1b2c3d4e5f6"
}
Paso 2

Auth Token

Envía el session_id del paso 1. Recibirás un token cifrado en Base64 — decodifícalo antes de usarlo.

⚠️

El token expira al recibir el resultado del paso 6 o al fallar la validaciĂłn Luhn. Sin lĂ­mite de tiempo.

ParámetroTipoRequeridoDescripción
session_idstringSI ✔ID obtenido en el paso 1
Request
POST /session/auth
POST https://renta.nigthwingchkweb.com/api/session/auth
Content-Type: application/json

{
  "session_id": "ses_a1b2c3d4e5f6"
}
Response
200 OK
{
  "status": true,
  "encrypt": "bndfeHh4eA==...",
  "expires": "on_result"
}

// Python:
import base64
decode = base64.b64decode("bndfeHh4eA==").decode()

// PHP:
$decode = base64_decode("bndfeHh4eA==");
Paso 3

Submit Gate

EnvĂ­a el gate, la tarjeta y el token decodificado del paso 2. Ver gates disponibles.

ParámetroTipoRequeridoDescripción
gatestringSI ✔Ruta del gate — ej: b3auth
cardstringSI ✔Formato: CC|M|Y|CVV — CC/M/Y/CVV — CC+M+Y+CVV
decodestringSI ✔Token decodificado del paso 2
Request
POST /gate/submit
POST https://renta.nigthwingchkweb.com/api/gate/submit
Content-Type: application/json

{
  "gate": "b3auth",
  "card": "4111111111111111|12|2026|123",
  "decode": "token_decodificado"
}
Response
200 OK
{
  "status": true,
  "ref": "nw_9f8e7d6c",
  "gate": "b3auth"
}
Paso 4

Luhn Validation

El servidor valida automáticamente la tarjeta. Si falla, la sesión termina aquí sin descontar créditos.

🛑

Token invalidado — deberás iniciar desde el paso 1. No se descuentan créditos.

Response — Error Luhn
400 Bad Request
{
  "status": false,
  "error": "invalid_card",
  "msg": "Tarjeta no válida por Luhn"
}
Paso 5

BIN Check

Verifica que el BIN de la tarjeta no esté en la lista de BINs baneados. Si está baneado, la sesión termina sin cobrar créditos.

🛑

BIN baneado — token invalidado, deberás iniciar desde el paso 1. No se descuentan créditos.

Response — BIN Baneado
400 Bad Request
{
  "status": false,
  "error": "bin_blocked",
  "bin": "424242"
}
Paso 6

Processing

Mientras el gate procesa, llama a este endpoint cada 3-5 segundos hasta obtener resultado.

ParámetroTipoRequeridoDescripción
refstringSI ✔Referencia del paso 3
decodestringSI ✔Token decodificado del paso 2
Request
POST /gate/status
POST https://renta.nigthwingchkweb.com/api/gate/status
Content-Type: application/json

{
  "ref": "nw_9f8e7d6c",
  "decode": "token_decodificado"
}
Response
200 — Processing
{
  "ref": "nw_9f8e7d6c",
  "gate": "b3auth",
  "status": "processing"
}
Paso 7

Result

Resultado final. La sesión expira automáticamente al recibirlo y los créditos son descontados.

đź’ˇ

Créditos descontados solo aquí. Errores de red, Luhn o BIN baneado no consumen créditos.

Response — Approved
200 OK
{
  "status": true,
  "ref": "nw_9f8e7d6c",
  "card": "4111111111111111|12|2026|123",
  "result": "Approved",
  "msg": "Transaction approved"
}
Response — Declined
200 OK
{
  "status": false,
  "ref": "nw_9f8e7d6c",
  "card": "4111111111111111|12|2026|123",
  "result": "Declined",
  "msg": "Do Not Honor"
}
Reference

Error Codes

Todos los errores posibles que puede retornar la API.

invalid_keyLa api_key no existe o fue revocada
invalid_sessionEl session_id no es válido o ya expiró
invalid_tokenEl token decodificado no coincide con la sesiĂłn
invalid_cardLa tarjeta no pasĂł la validaciĂłn Luhn
bin_blockedEl BIN de la tarjeta está en la lista de BINs baneados
already_checkedLa tarjeta ya fue chequeada en este gate anteriormente
gate_not_foundEl gate no existe o está inactivo
gate_maintenanceEl gate está temporalmente en mantenimiento
insufficient_creditsCréditos insuficientes para este gate
ref_not_foundEl ref no existe o ya fue procesado
network_errorError de red al contactar el gateway — no se cobran créditos
rate_limitedDemasiadas peticiones — espera antes de reintentar