API Market KASU V1

Validate_Mexico

Valida CURP y RFC con caché y modelo prepago, incluyendo consultas upstream controladas.
Modelo CURP/RFC
Versión V1
Protocolo HTTP POST JSON
URI Live https://apimarket.kasu.com.mx/api/ValidateMexico_V1
URI Sandbox https://apimarket.kasu.com.mx/api/ValidateMexico_V1
Versiones

Historial de documentación

Consulta la versión vigente del contrato y las revisiones publicadas para esta API.

Version Release date Documentation

Última versión

Última versión: — Fecha:

Sin descripción.
Validate_Mexico

Endpoints y autenticación

El endpoint V1 recibe solicitudes JSON por POST. Todas las operaciones requieren Authorization: Bearer, nombre_de_usuario, curp_en_uso y token_data.

Token

Token_Full

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

Genera la credencial Bearer con el flujo HMAC vigente.

API

ValidateMexico_V1

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

Valida CURP/RFC y retorna origen de respuesta, costo, saldo y datos del proveedor.

Métodos disponibles

Los métodos públicos usan wallet/prepago y caché. Las consultas upstream operativas deben restringirse a usuarios autorizados.

Método Descripción Modelo
curp_validate Valida y obtiene datos por CURP. Prepago; cobra si la consulta es exitosa.
rfc_validate Valida y obtiene datos por RFC. Prepago; cobra si la consulta es exitosa.
upstream_saldo Consulta saldo del proveedor upstream. Operativo; no descuenta wallet.
upstream_peticiones Consulta historial upstream por página. Operativo; no descuenta wallet.

Ejemplos de consumo

También se acepta request como alias de metodo. El valor a validar viaja en valor.

CURP

curp_validate

POST https://apimarket.kasu.com.mx/api/ValidateMexico_V1
Authorization: Bearer API_KEY_AQUI
Content-Type: application/json
User-Agent: SECRET_KEY_USUARIO_SECRET_KEY_ID

{
  "tipo_peticion": "request",
  "nombre_de_usuario": "YOUR_APPUSER",
  "curp_en_uso": "CURP_CODE",
  "metodo": "curp_validate",
  "valor": "AAAA000000HDFXXX00",
  "token_data": {
    "timestamp": TIMESTAMP,
    "expires_in": EXPIRE_IN
  }
}
RFC

rfc_validate

POST https://apimarket.kasu.com.mx/api/ValidateMexico_V1
Authorization: Bearer API_KEY_AQUI
Content-Type: application/json
User-Agent: SECRET_KEY_USUARIO_SECRET_KEY_ID

{
  "tipo_peticion": "request",
  "nombre_de_usuario": "YOUR_APPUSER",
  "curp_en_uso": "CURP_CODE",
  "metodo": "rfc_validate",
  "valor": "ABC123456T89",
  "token_data": {
    "timestamp": TIMESTAMP,
    "expires_in": EXPIRE_IN
  }
}

Respuesta y errores

La respuesta exitosa incluye el origen de datos (cache o upstream), costo en centavos, saldo restante, payload y tiempo de procesamiento.

Respuesta positiva

{
  "ok": true,
  "success": true,
  "origen": "cache",
  "costo_centavos": 200,
  "saldo_centavos": 499800,
  "data": {
    "Response": "correct",
    "Curp": "AAAA000000HDFXXX00"
  },
  "ms": 34
}

Códigos HTTP

200Solicitud procesada.
400JSON inválido, método faltante o valor inválido.
401Bearer token faltante o inválido.
402Saldo insuficiente.
403Usuario inactivo o sin permisos.
405Método HTTP no permitido; solo POST.
502Error del proveedor upstream.
Sandbox

Pruebas sin impacto productivo

Usa estos valores para construir solicitudes y validar respuesta JSON. Las llaves privadas reales se entregan por canal seguro y no deben publicarse en documentación.

Entorno de integración

Esta API incluye un entorno Sandbox para pruebas previas a producción.

Las pruebas de alta de cuentas y pagos deben ejecutarse únicamente con usuarios sandbox autorizados.

Recursos relacionados

Postman tutorial

PETICIÓN DATOS PARA MODO SANDBOX
PRIVATE_KEY Se entrega por canal seguro
nombre_de_usuario Api_KASU_Sandbox
curp_en_uso CAMC880526HMCBNR04
poliza_en_uso e0ab0e9a
curp_en_uso REAE060617MMCYLVA4
poliza_en_uso ae670d65

Otras APIs que te pueden interesar


PREPAGO

API_CUSTOMER

/api/Customer_V1

Consulta catálogo, cliente, producto viable y ventas por CURP/póliza con autorización válida.


Ver documentación
POSPAGO

API_PAYMENTS

/api/Payments_V1

Consulta estado de cuenta y registra pagos PSD2 con saldo, mora y transición de estatus.


Ver documentación
GRATIS

API_ACCOUNTS

/api/Accounts_V1

Registra servicios KASU con venta, póliza, liga de pago y datos legales aceptados.


Ver documentación
CURP/RFC

Validate_Mexico

/api/ValidateMexico_V1

Valida CURP/RFC con caché, wallet prepago y consultas upstream controladas.


Ver documentación