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.

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 DESCRIPCIÓN DE CLAVES DE FUNCIONES
request Retorna las claves y datos consultables.
individual_request Búsqueda puntual: Contacto cliente, datos personales o una venta específica.
request_block Búsqueda por conjunto de datos específico.

Consulta base

Envía el token Bearer, el usuario API, la CURP ligada al token y la estructura token_data recibida desde Token_Full.

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 Clave de búsqueda requerida.
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 frecuentes

request lista claves disponibles, individual_request devuelve un campo puntual y request_block devuelve bloques completos.

request_block

Datos completos del cliente

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
  }
}
individual_request

Campo de venta

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

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