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, la función new_service y los productos habilitados para alta desde /api/Accounts_V1.

CÓDIGOS	DESCRIPCIÓN
200	Petición exitosa. Respuesta en JSON.
400	Falta algún dato requerido por la solicitud.
401	Comunicación corrupta. Datos modificados.
404	Petición desconocida. Solo se admiten claves documentadas.
405	El método HTTP es distinto de POST.
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.

CLAVES DE FUNCIONES	DESCRIPCIÓN
token_full	Genera un token de autorización de uso con vigencia de 10 minutos.
new_service	Registra un cliente KASU.
account_status	Consulta el estado de cuenta desde API_PAYMENTS.

PRODUCTOS	DESCRIPCIÓN
Funerario	Servicio de Gastos Funerarios 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 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	No se aceptó fideicomiso, privacidad o términos.

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.poliza	Póliza única del servicio.
datos_compra.status	Estatus inicial del servicio: PREVENTA.
datos_compra.subtotal	Total de la venta o crédito.
datos_compra.amount	Monto inicial a cobrar.
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