API Market KASU V1

APIs para registrar servicios, cobrar, consultar clientes y validar identidad.

Integra API_ACCOUNTS, API_PAYMENTS, API_CUSTOMER y Validate_Mexico con autenticación Token_Full, Bearer token y respuestas JSON consistentes.

4 APIs V1 públicas
JSON Errores y respuestas
Bearer Autorización
Contrato público vigente V1
POST https://apimarket.kasu.com.mx/api/Accounts_V1
Authorization: Bearer API_KEY_AQUI
Content-Type: application/json

{
  "tipo_peticion": "new_service",
  "nombre_de_usuario": "YOUR_APPUSER",
  "curp_en_uso": "CURP_CODE",
  "producto": "Funerario",
  "terminos": "acepto",
  "aviso": "acepto",
  "fideicomiso": "acepto",
  "token_data": {
    "timestamp": 1760000000,
    "expires_in": 600
  }
}

1,157 Clientes Activos

API Market KASU expone los flujos transaccionales de la plataforma para aliados: alta de servicios, consulta de clientes, cobranza y validación de identidad. El contrato público vigente usa endpoints V1 y autenticación Token_Full.

Casos de uso

Opera servicios KASU desde tu plataforma

Registra ventas, consulta datos autorizados, cobra parcialidades y valida CURP/RFC usando respuestas JSON estables para integración web, móvil o backoffice.



Documentación

Selecciona la API que necesitas integrar


PREPAGO

API_CUSTOMER

/api/Customer_V1

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

POSPAGO

API_PAYMENTS

/api/Payments_V1

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

GRATIS

API_ACCOUNTS

/api/Accounts_V1

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

CURP/RFC

Validate_Mexico

/api/ValidateMexico_V1

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

USABILIDAD GENERAL


Las APIs V1 comparten autenticación, errores JSON y datos de token. Cada token se liga al usuario, a la CURP de operación y a los permisos habilitados para tu integración.


1. Token_Full Genera el Bearer token con firma HMAC y vigencia de 10 minutos.
2. Accounts Crea contacto, usuario, legal, venta y liga de pago.
3. Customer Consulta datos autorizados, catálogo y ventas por CURP.
4. Payments Consulta estado de cuenta y registra pagos con mora si aplica.
5. Validate_Mexico Valida CURP/RFC con caché y wallet prepago.
Autenticación

Token_Full y Bearer token

Flujo de autenticación: firma HMAC, generación de token_full y consumo de APIs V1 con Authorization: Bearer. Los ejemplos específicos de consumo están en la documentación de cada API.

La petición debe ser por método POST; el cuerpo debe enviarse como Content-Type: application/json.


Parámetro Descripción
tipo_peticion Debe enviarse como token_full.
User-Agent Identificador técnico asignado en Secret_KEY, con formato USUARIO_ID.
YOUR_APPUSER Tu nombre de usuario registrado en la aplicación KASU.
Firma_KEY Firma la CURP de tu cliente con tu PRIVATE_KEY mediante HMAC SHA-256.
curp_en_uso CURP que quedará ligada al token y a la petición.
            
POST https://apimarket.kasu.com.mx/api/Token_Full

  Headers:
  Content-Type: application/json
  User-Agent: SECRET_KEY_USUARIO_SECRET_KEY_ID
  Body:
  {
    "tipo_peticion"     : "token_full",
    "nombre_de_usuario" : "YOUR_APPUSER",
    "firma_KEY"         : "FIRMA_KEY",
    "curp_en_uso"       : "CURP_CODE"
  }
            
          

Respuesta y errores de autenticación

Token_Full resuelve la credencial de API Market V1 y retorna errores JSON cuando no puede generar el token.

PETICIÓN DESCRIPCIÓN
token_full Solicita la generación de un token de autorización con vigencia de 10 minutos.
CODIGO ERRORES DE PETICION
403 Credenciales inválidas, firma incorrecta o usuario inexistente.
417 CURP inválida o no elegible.

Cuando Token_Full retorna una respuesta positiva entrega los siguientes valores:


LLAVE DESCRIPCIÓN
token TOKEN generado por API Market V1.
nombre Retorna el nombre completo de el cliente.
timestamp Dentro de token_data tiempo que se genero el TOKEN
expires_in Dentro de token_data vigencia del TOKEN generado

Acceso a KASU API

Solicita acceso a KASU API y describe tu caso de uso. Indícanos la empresa y un contacto, qué integrarás, las APIs que necesitas y el volumen esperado: sitio web, usuarios estimados y RPS máximo. Con esa información evaluamos tu solicitud y te habilitamos sandbox.