Validate_Mexico CURP / RFC

Servicio de validación para obtener datos asociados a CURP y RFC mediante Conéctame (upstream SOAP), con caché para optimización y modelo prepago para subdistribuidores.

Endpoints

Token (Bearer)

https://apimarket.kasu.com.mx/Token_Full.php

Genera un token de acceso (Authorization: Bearer) para consumir la API.

API Validate_Mexico

https://apimarket.kasu.com.mx/api/ValidateMexico_V1.php

Recibe solicitudes JSON por POST.

Modelo de cobro y caché

Cobro por consulta exitosa: solo se descuenta saldo cuando la respuesta es exitosa.
Precio igual aunque sea caché: el costo por éxito es el mismo venga de BD (caché) o upstream.
Caché: si la CURP/RFC ya existe y está vigente, el sistema responde sin llamar al proveedor.
TTL sugerido: 30 días (configurable a nivel de implementación).

Métodos disponibles

Método	Descripción	¿Cobrable?
`curp_validate`	Valida y obtiene datos por CURP.	Sí (solo si éxito)
`rfc_validate`	Obtiene datos por RFC.	Sí (solo si éxito)
`upstream_saldo`	Consulta saldo del proveedor upstream (solo admin/soporte).	No
`upstream_peticiones`	Consulta historial upstream por página (solo admin/soporte).	No

Autenticación

Debe enviarse el token en la cabecera:

Authorization: Bearer <TOKEN>
Content-Type: application/json

La generación/validación del token depende del módulo actual de API Market (Token_Full.php / Validador_Token.php).

Ejemplo 1: Validar CURP

{
  "tipo_peticion": "request",
  "nombre_de_usuario": "Api_telecom_bienestar",
  "metodo": "curp_validate",
  "valor": "AAAA000000HDFXXX00"
}

Respuesta (ejemplo)

{
  "ok": true,
  "success": true,
  "origen": "cache",
  "costo_centavos": 200,
  "saldo_centavos": 499800,
  "data": {
    "Response": "correct",
    "Curp": "AAAA000000HDFXXX00",
    "Nombre": "NOMBRE",
    "Paterno": "APELLIDO",
    "Materno": "APELLIDO",
    "Sexo": "H",
    "FechaNacimiento": "2000-01-01",
    "Nacionalidad": "MEX",
    "StatusCurp": "OK"
  },
  "ms": 34
}

Ejemplo 2: Validar RFC

{
  "tipo_peticion": "request",
  "nombre_de_usuario": "Api_telecom_bienestar",
  "metodo": "rfc_validate",
  "valor": "ABC123456T89"
}

Precios

Los precios se gestionan desde la tabla api_pricing por método. Valores típicos:

Método	Precio éxito	Precio fallo
`curp_validate`	$2.00 MXN (200 centavos)	$0.00 MXN
`rfc_validate`	$2.00 MXN (200 centavos)	$0.00 MXN

Códigos HTTP

Código	Significado
`200`	Solicitud procesada (revisar `success`).
`400`	Solicitud inválida (JSON inválido, método faltante, valor inválido).
`401`	No autorizado (token faltante o inválido).
`402`	Saldo insuficiente (prepago).
`403`	Prohibido (usuario inactivo o sin permisos).
`405`	Método HTTP no permitido (solo POST).
`429`	Límite de solicitudes (rate limit, si aplica).
`502`	Error del proveedor upstream (SOAP).
`500`	Error interno.

Notas de privacidad

Para auditoría se recomienda registrar hash del valor consultado (CURP/RFC) en lugar del valor en claro.
La respuesta completa puede almacenarse como JSON en caché (según política interna).