DESCRIPCION


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.

Nombre Api: PAYMENTS
Versión: 2.0
Protocolo: HTTP
URI Live: https://apimarket.kasu.com.mx/api/Payments_V2
URI Sandbox: https://apimarket.kasu.com.mx/api/Payments_sbx
Version Release date Documentation
V24 Nov 2025(this page)
V101 Abr 2023(this page)

HISTORIAL DE VERSIONES

Ú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


CODIGOS GENERALES


Estos son los codigos generales generados por API_REGISTRO, y las claves para envio de datos.


CODIGOS DESCRIPCION
200Peticion exitosa, retorna en formato JSON.
400Falta algun dato necesario de los que requiere la solicitud.
401La comunicacion entre el cliente y el servidor fue corrupta.
404Petición desconocida. Solo se admiten las claves documentadas.
405El método HTTP es distinto a POST.
412El cliente ya está registrado con el producto seleccionado.
417La CURP pertenece a persona fallecida o no existe.
418Tiempo de operación excedido para este TOKEN.
CLAVES DE FUNCIONES DESCRIPCION
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.
new_serviceRegistra un cliente KASU.
modify_recordObtiene el precio de un producto KASU.

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 de alcance insuficiente.

Funcionalidades habilitables — Lado Usuario

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

Resolución interna — Lado KASU

Ref FuncOperación interna
4Registra el pago del cliente en el sistema transaccional.
4Asigna la comisión generada al prospecto según la tabla de productos.
1Consulta la póliza por Número de Póliza y calcula el saldo total.
2Consulta la póliza por Número de Póliza y determina el pago del periodo.
3Consulta 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.

SANDBOX


entorno aislado que replica producción para pruebas seguras. Usa HTTPS, método POST, encabezado Content-Type: application/json y autenticación por Bearer token. Ideal para probar con Postman u otro cliente HTTP.


RELATED RESOURCES


Postman tutorial
Calculadora de préstamos
PETICIÓN DATOS PARA MODO SANDBOX
PRIVATE_KEY ef235aacf90d9f4aadd8c92e4b2562e1d9eb97f0
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 pueren interesar


PREPAGO

API_CUSTOMER


Comparte y valida datos de clientes con consultas rápidas y seguras.

POSPAGO

API_PAYMENTS


Cobros en tiempo real con conciliación y comisiones integradas.

GRATIS

API_ACCOUNTS


Apertura de servicios KASU desde tu plataforma y comisiones por venta.

CURP/RFC

Validate_Mexico


Validación de identidad con caché y modelo prepago para CURP y RFC.