API Market KASU V1

PAYMENTS

API_PAYMENTS de KASU es un servicio REST permite a tus aplicaciones consultar; el saldo total de una póliza, realizar el pago de una poliza, la comisión que genera cada pago y consultar el monto de pago de una poliza en tiempo real.

Ofrece autenticación basada en token, respuestas JSON consistentes y activación selectiva de capacidades por token para un control preciso. Se integra en minutos, asegura trazabilidad de cada operación. Ideal para apps que desean generar comisiones por operaciones financieras dentro de tus plataformas de atención al cliente.

Modelo POSPAGO

Versión 2.0

Protocolo HTTP POST JSON

URI Live https://apimarket.kasu.com.mx/api/Payments_V2

URI Sandbox https://apimarket.kasu.com.mx/api/Payments_sbx

Versiones

Historial de documentación

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

Version	Release date	Documentation
V2	4 Nov 2025	(this page)
V1	01 Abr 2023	(this page)

Última versión

Última versión: V2 — Fecha: 4 Nov 2025

Esta version implemeta, cambios en el registro de pagos y generación de comisiones, de igual manera permite la consulta de pagos a dar por un cliente según su ciclo de cliente

API_PAYMENTS

Códigos, funciones y permisos

Estos son los códigos generales generados por API_PAYMENTS y las funciones admitidas por /api/Payments_V1.

CÓDIGOS	DESCRIPCIÓN
200	Petición exitosa, retorna en formato JSON.
400	Falta algún dato necesario de los que requiere la solicitud.
401	Token faltante, inválido o comunicación corrupta.
404	Petición desconocida. Solo se admiten las claves documentadas.
405	El método HTTP es distinto a POST.
412	El cliente ya está registrado con el producto seleccionado.
417	La CURP pertenece a persona fallecida o no existe.
418	Tiempo de operación excedido para este TOKEN.

CLAVES DE FUNCIONES	DESCRIPCIÓN
token_full	Acceso único a todas las API KASU. Cada token se emite con permisos finos y activamos de forma selectiva las funcionalidades asignadas a ese token.
account_status	Consulta saldo, pago del periodo, mora y estado de cobranza.
pagos_psd2	Registra un pago y aplica primero mora cuando corresponde.

ALCANCE DEL TOKEN Y PERMISOS

Al generar token_full se crea una credencial única. Sobre esa credencial habilitamos las capacidades listadas abajo. Si una capacidad no está asociada a tu token, la API responderá con error de autorización o alcance insuficiente.

Funcionalidades habilitables — Lado Usuario

Ref Func	Funcionalidad
1	Permite consultar el saldo total de la póliza.
2	Permite consultar el pago del periodo.
3	Permite consultar la comisión del pago del periodo.
4	Permite registrar el pago de un cliente.

Resolución interna — Lado KASU

Ref Func	Operación interna
4	Registra el pago del cliente en el sistema transaccional.
4	Asigna la comisión generada al prospecto según la tabla de productos.
1	Consulta la póliza por Número de Póliza y calcula el saldo total.
2	Consulta la póliza por Número de Póliza y determina el pago del periodo.
3	Consulta en Productos la comisión aplicable y la devuelve desglosada.

Nota: La activación de cada Ref Func se liga al token emitido. Podrás verificar tus permisos activos en la respuesta del endpoint de autenticación o con tu ejecutivo de integración.

Ejemplos de consumo

Ambas operaciones requieren curp_en_uso, poliza_en_uso, Bearer token y token_data.

account_status

Consulta saldo, pago de periodo, mora, pagos realizados, pagos pendientes, comisión y liga de pago.

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

{
  "tipo_peticion": "account_status",
  "nombre_de_usuario": "YOUR_APPUSER",
  "curp_en_uso": "CURP_CODE",
  "poliza_en_uso": "POLIZA",
  "token_data": {
    "timestamp": TIMESTAMP,
    "expires_in": EXPIRE_IN
  }
}

pagos_psd2

Registra un pago. Si existe mora, la API aplica primero la mora y después el abono principal.

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

{
  "tipo_peticion": "pagos_psd2",
  "nombre_de_usuario": "YOUR_APPUSER",
  "curp_en_uso": "CURP_CODE",
  "poliza_en_uso": "POLIZA",
  "cantidad": 850.00,
  "metodo": "API_PAYMENTS",
  "referencia": 123,
  "token_data": {
    "timestamp": TIMESTAMP,
    "expires_in": EXPIRE_IN
  }
}

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