API Market KASU V1

ACCOUNTS

Para utilizar esta API, el usuario debe proporcionar una API_KEY válida y estar autenticado para realizar la operación de registro de productos. Los parámetros necesarios para registrar un nuevo producto son: el nombre del producto, la descripción, el precio, el tipo de producto y la categoría. Además, se puede proporcionar información adicional como imágenes y videos de marketing para ayudar en la promoción del producto Para utilizar esta API, el usuario debe proporcionar una API_KEY válida y estar autenticado para realizar la operación de registro y modificacion de productos. Los parámetros necesarios para registrar un nuevo producto son las mostradas en esta documentacion

Modelo ALTA DE SERVICIO

Versión 1.0

Protocolo HTTP POST JSON

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

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

Versiones

Historial de documentación

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

Version	Release date	Documentation
V1	01 Mar 2023	(this page)

Última versión

Última versión: V1 — Fecha: 01 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_ACCOUNTS

Códigos, funciones y productos

Estos son los códigos generales generados por API_ACCOUNTS y la única función admitida por el endpoint /api/Accounts_V1. ALTA DE SERVICIO

CÓDIGOS	DESCRIPCIÓN
201	Registro exitoso. Retorna datos de la venta creada en JSON.
400	Falta algún dato requerido por la solicitud.
401	Token Bearer faltante, inválido o expirado (Validador_Token).
404	Petición desconocida. Solo se admite new_service.
405	El método HTTP es distinto de POST.
406	Producto no viable para la edad del cliente o inexistente.
409	Email o teléfono ya registrados, o falta aceptación de términos/aviso/fideicomiso.
412	El cliente ya está registrado con el producto seleccionado.
417	CURP de persona fallecida o inexistente.
418	Tiempo de operación excedido para este TOKEN (Validador_Token).
500	Error interno del servidor o de base de datos.

CLAVES DE FUNCIONES	DESCRIPCIÓN
new_service	Registra un cliente KASU, genera póliza, venta y liga de pago.

PRODUCTOS	DESCRIPCIÓN
Funerario	Servicio de Gastos Funerarios ligado a la edad.
Seguridad	Servicio de Seguridad y Protección ligado a la edad.
Transporte	Servicio de Transporte ligado a la edad.
Retiro	Plan Privado de Retiro para adultos menores de 65 años.

Registrar servicio

Reemplaza los valores de ejemplo por datos reales del cliente y producto. Las aceptaciones legales admiten acepto o accept.

Parámetro	Descripción
API_KEY_AQUI	Token recibido de AUTENTICACIÓN.
tipo_peticion	Tipo de petición según tablas de acceso.
YOUR_APPUSER	Usuario registrado en KASU.
CURP_CODE	CURP del cliente.
mail	Correo del cliente.
telefono	Teléfono del cliente, 10 dígitos MX.
producto	Producto solicitado: Funerario, Seguridad, Transporte o Retiro, sujeto a edad y catálogo.
numero_pagos	Número de pagos elegidos. Si es mayor a 1 se calcula crédito.
dia_pago	Día de pago mensual permitido: 1 o 15. En contado se registra como 0.
tipo_servicio	Tipo de servicio KASU. Si no se envía, se usa Ecologico.
terminos	Aceptación de Términos y Condiciones. Valores: acepto o accept.
aviso	Aceptación del Aviso de Privacidad. Valores: acepto o accept.
fideicomiso	Ingreso al Fideicomiso F/0003. Valores: acepto o accept.
direccion.calle	Calle del cliente.
direccion.numero	Número de casa.
direccion.colonia	Colonia.
direccion.municipio	Municipio.
direccion.codigo_postal	Código Postal.
direccion.estado	Estado.
TIMESTAMP	Tiempo de generación del token de acceso.
EXPIRE_IN	Segundos de vigencia del token.

						
							POST https://apimarket.kasu.com.mx/api/Accounts_V1

							Headers:
							Authorization: Bearer API_KEY_AQUI

							Content-Type: application/json
							User-Agent: SECRET_KEY_USUARIO_SECRET_KEY_ID

							{
							"tipo_peticion": "new_service",
							"nombre_de_usuario": "YOUR_APPUSER",
							"curp_en_uso": "CURP_CODE",
							"mail": "CORREO_ELECTRONICO",
							"telefono": TELEFONO,
							"producto": "PRODUCTO",
							"numero_pagos": NUMERO_PAGOS,
							"dia_pago": 1,
							"tipo_servicio": "Ecologico",
							"terminos": "acepto",
							"aviso": "acepto",
							"fideicomiso": "acepto",
							"direccion": {
								"calle": "CALLE",
								"numero": NUMERO,
								"colonia": "COLONIA",
								"municipio": "MUNICIPIO",
								"codigo_postal": CODIGO_POSTAL,
								"estado": "ESTADO"
							},

							"token_data": {
								"timestamp": TIMESTAMP,
								"expires_in": EXPIRE_IN
							}

							}

Respuesta de new_service

La API retorna códigos de error cuando no resuelve correctamente la solicitud y una respuesta 201 cuando crea la venta en estatus PREVENTA.

CLAVE	DESCRIPCIÓN DE CLAVES DE FUNCIONES
new_service	Registra un cliente KASU.

CÓDIGO	ERRORES DE PETICIÓN
201	Registro exitoso con estatus PREVENTA.
406	Edad fuera de rango o producto inexistente.
409	Email o teléfono duplicados, o no se aceptó fideicomiso/privacidad/términos.
412	Cliente ya registrado con el mismo producto.
417	CURP no válida, fallecida o no elegible.

LLAVE	RESPUESTA POSITIVA
mensaje	Mensaje de éxito con el SERVICIO.
datos_compra.id_venta	Identificador de la venta creada.
datos_compra.id_contacto	Identificador del contacto creado.
datos_compra.nombre	Nombre del cliente según validación CURP.
datos_compra.CURP	CURP ligada al servicio KASU.
datos_compra.mail	Correo ligado al servicio.
datos_compra.producto	Código interno del producto asignado según edad.
datos_compra.poliza	Póliza única del servicio (IdFirma).
datos_compra.status	Estatus inicial del servicio: PREVENTA.
datos_compra.costo	Costo base del producto (CostoVenta).
datos_compra.subtotal	Total de la venta o crédito.
datos_compra.amount	Monto inicial a cobrar (por pago si es crédito).
datos_compra.plan	Modalidad: CONTADO o MENSUAL.
datos_compra.numero_pagos	Número de pagos del plan.
datos_compra.dia_pago	Día de pago mensual (1, 15) o 0 si es contado.
datos_compra.pago_link	Liga para generar o continuar el pago.

La respuesta incluye los datos mínimos para continuar cobranza con API_PAYMENTS o con la liga de pago.

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