API Market KASU V1

CUSTOMER

La API de KASU permite a los desarrolladores acceder a los datos de los productos, como su nombre, precio, descripción y existencias. También permite obtener información de los clientes, como su nombre, correo electrónico, dirección y datos de contacto. Además, la API de KASU proporciona acceso a los datos de usuario, como la información de inicio de sesión y las preferencias de cuenta.
Modelo PREPAGO
Versión 1.0
Protocolo HTTP POST JSON
URI Live https://apimarket.kasu.com.mx/api/Customer_V1
URI Sandbox https://apimarket.kasu.com.mx/api/Customer_sbx
Versiones

Historial de documentación

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

Version Release date Documentation
V115 Mar 2023(this page)

Última versión

Última versión: V1 — Fecha: 15 Mar 2023

Beta Release Sandbox
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
API_CUSTOMER

Códigos y funciones disponibles

Estos son los códigos generales generados por API_CUSTOMER y las claves admitidas por el endpoint /api/Customer_V1. GRATIS

CÓDIGOS DESCRIPCIÓN
202Consulta de datos exitosa.
400Falta algún dato necesario de los que requiere la solicitud.
401La comunicación entre el cliente y el servidor fue corrupta. Los datos fueron modificados.
404Petición desconocida. Solo se admiten las claves de funciones de la documentación.
405El método HTTP utilizado en la solicitud es distinto a POST.
406El producto excede los límites de edad para el producto seleccionado o el producto no existe.
409El cliente no autorizó la consulta de sus datos o la clave de aceptación es incorrecta.
412La condición que buscas no es correcta o no es apta para ser consultada.
418Has excedido el tiempo de operación para este TOKEN.
tipo_peticion request Resultado
request request_block Lista los bloques de datos consultables.
request individual_request Lista los campos individuales consultables.
individual_request Nombre del campo Devuelve el valor de un campo puntual del cliente o venta.
request_block cliente Devuelve todos los datos del cliente, contacto y ventas.
request_block producto_cliente Evalúa viabilidad de un producto para el cliente (requiere parámetro producto).
request_block catalogo_productos Devuelve el catálogo completo de productos con costos y comisiones.

Descubrimiento de campos

Usa tipo_peticion: request para descubrir qué bloques y campos están disponibles. La API usa enrutamiento de 2 niveles: tipo_peticion define la operación y request define el objetivo.

Parámetro DESCRIPCIÓN
API_KEY_AQUI Reemplaza por el TOKEN recibido en AUTENTICACIÓN.
tipo_peticion General, individual o por bloque según la clave.
YOUR_APPUSER Tu usuario registrado en KASU.
CLAVE_CONSULTA Para descubrir: request_block (lista bloques) o individual_request (lista campos).
CURP_CODE CURP con la que generaste el API_KEY.
TIMESTAMP Instante de generación del token de ACCESO.
EXPIRE_IN Vigencia del token devuelto por ACCESO. 
							
								POST https://apimarket.kasu.com.mx/api/Customer_V1

								Headers:
								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",
									"request": "CLAVE_CONSULTA",
									"curp_en_uso": "CURP_CODE",
									"token_data": {
										"timestamp": TIMESTAMP,
										"expires_in": EXPIRE_IN
									}
								}

Ejemplos de consumo

request_block devuelve bloques completos de datos. individual_request devuelve un campo puntual. Campos de venta incluyen Subtotal, DiaPago, IdFirma y FechaLiquidacion.

request_block

Datos del cliente

request: cliente – Retorna datos de contacto, usuario, dirección y todas las ventas asociadas.

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

{
  "tipo_peticion": "request_block",
  "nombre_de_usuario": "YOUR_APPUSER",
  "request": "cliente",
  "curp_en_uso": "CURP_CODE",
  "token_data": {
    "timestamp": TIMESTAMP,
    "expires_in": EXPIRE_IN
  }
}

// Respuesta (202):
{
  "ok": true,
  "curp_en_uso": "CURP_CODE",
  "Ejecutivo": "usuario_api",
  "Nombre": "Juan Perez Lopez",
  "Tipo": "Cliente",
  "Mail": "cliente@mail.com",
  "Telefono": "5512345678",
  "Producto": "02a29",
  "FechaRegistro": "2025-01-15",
  "Direccion": {
    "calle": "...", "numero": "...",
    "colonia": "...", "municipio": "...",
    "codigo_postal": "...", "estado": "..."
  },
  "ventas": [{ ... }]
}
request_block

Viabilidad de producto

request: producto_cliente – Evalúa si un producto es viable para la edad del cliente. Requiere el parámetro adicional producto con el nombre del producto (ej. "Funerario").

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

{
  "tipo_peticion": "request_block",
  "nombre_de_usuario": "YOUR_APPUSER",
  "request": "producto_cliente",
  "curp_en_uso": "CURP_CODE",
  "producto": "Funerario",
  "token_data": {
    "timestamp": TIMESTAMP,
    "expires_in": EXPIRE_IN
  }
}

// Respuesta (202):
{
  "ok": true,
  "producto": "02a29",
  "costo": 3500.00,
  "comision": 350.00,
  "forma_pago": {
    "meses_max": 12,
    "tasa_anual": 0.00
  }
}
request_block

Catálogo de productos

request: catalogo_productos – Lista todos los productos con costo, comisión, fideicomiso y condiciones de crédito.

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

{
  "tipo_peticion": "request_block",
  "nombre_de_usuario": "YOUR_APPUSER",
  "request": "catalogo_productos",
  "curp_en_uso": "CURP_CODE",
  "token_data": {
    "timestamp": TIMESTAMP,
    "expires_in": EXPIRE_IN
  }
}

// Respuesta (202):
{
  "ok": true,
  "productos": [
    {
      "producto": "02a29",
      "costo": 3500.00,
      "comision": 350.00,
      "fideicomiso": "50.00",
      "forma_pago": { "meses_max": 12, "tasa_anual": 0 }
    },
    ...
  ]
}
individual_request

Campo individual

tipo_peticion: individual_request – Retorna el valor de un solo campo. Usa individual_request primero para ver campos disponibles.

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

{
  "tipo_peticion": "individual_request",
  "nombre_de_usuario": "YOUR_APPUSER",
  "request": "Status",
  "curp_en_uso": "CURP_CODE",
  "token_data": {
    "timestamp": TIMESTAMP,
    "expires_in": EXPIRE_IN
  }
}

// Respuesta (202):
{
  "ok": true,
  "curp_en_uso": "CURP_CODE",
  "request": "Status",
  "data": "ACTIVO"
}

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