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


API_CUSTOMER


La API_CUSTOMER permite a clientes de KASU compartir su información en un solo clic. Evita los interminables formularios de registro con datos clave, veraces y actualizados. Elimina fricciones y mejora la experiencia de tus clientes.

API_PAYMENTS


Con API_PAYMENTS Puedes confirmar en tiempo real los pagos que los clientes KASU realicen en tu negocio. De esta forma, puedes generar interesantes comisiones. También puedes mostrar el adeudo para facilitar su cobranza al momento.

API_ACCOUNTS


Con la API_ACCOUNTS podrás ofrecer la apertura de servicios KASU en tu app o plataforma digital en cuestión de minutos. Fideliza a tus clientes, empleados o proveedores generando en el camino interesantes comisiones.