KashIO Payments

Integración RECAUDOS

Manual Técnico
Oct 2020
 PLATAFORMA
Plataformas de
medios de pago

• Plataforma Financiera desarrollada por Comercios Instituciones

un equipo experto de amplia experiencia

internacional.
CRM SAAS
• Orientada a maximizar la eficiencia de CRM SAAS

los procesos financieros de las

empresas.

• Diseñada para operar con cualquier ERP

ERP POS
PSP (Payment Service Provider) del
mercado.
Usuarios no Usuarios
bancarizados bancarizados
 ARQUITECTURA DE LA PLATAFORMA

Procesos
CONCILIACIÓN
PAGOS RECAUDOS COBRANZAS
BANCARIA

Funcionalidades
MULTIMONEDA PANEL DE NOTIFICACIONES GESTIÓN DE REPORTES
CONTROL EVENTOS

Características
FLEXIBLE ALTA SEGURIDAD Y ESCALABLE INTEROPERABLE
DISPONIBILIDAD COMPATIBILIDAD

© KashIO 2021 - Privileged/Confidential Information WWW.KASHIO.NET

 Como funciona – Recaudos ?

KashIO envia notificaciones El cliente ingresa su CODIGO DE

1 automatizadas de Ordenes de Pago 2 CLIENTE y selecciona las Ordenes de
a clients (email, whatsapp, sms) Pago a pagar en el banco o agente.

© KashIO 2021 - Privileged/Confidential Information WWW.KASHIO.NET

Procesos de Pago
KashIO provee una solución completa para sus procesos de pagos y cobranzas. La capa API
permite el mantenimiento de clientes y deudas, así como la notificación de pagos en tiempo-real, de
modo de tener una solución integral y automatizada desde la creación de deudas hasta la
reconciliación de operaciones.

KashIO PAYMENTS

Sistema de
INTEGRACION COBRO PAGO RECONCILIACION
Empresa

• Carga de datos a • Creación de • Control de Pagos • Reportes de Pagos

(Clientes y Ordenes de Procesos de Cobro de Clientes
Pago) • Reportes de Liquidación
• Notificación de orden • Interconexión con
• Opciones: API, Web o de pago vía email, PSP (bancos, • Panel de Control
archivo CSV SMS & Whatsapp agentes cash)

© KashIO 2021 - Privileged/Confidential Information WWW.KASHIO.NET

 Flujo de Pago
1. Empresa crea deudas en KashIO
Crea
1 API Empresa
2. Banco/Agente consulta las deudas Deuda
usando CODIGO DE PAGO ingresado
por cliente.
API PSP 2 Consulta
3. Banco notifica el pago de deuda a
KashIO
Listener 3 Notificador
4. KashIO notifica el pago de deuda a
Empresa
Listener 4 Notificador

EMPRESA KASHIO BANCOS

© KashIO 2021 - Privileged/Confidential Information WWW.KASHIO.NET

 1. Creación de deuda
La Creación de la deuda en KashIO consiste en una llamada POST a la API de KashIO
Payments //invoices

POST http://cert-api.kashio.net/v1/payments/invoices {
"request_datetime": "2018-01-01T20:15:23",
accept: application/json
"invoice_id": "id_123456",
content-type: application/json
"currency": "PEN",
authorization: Basic XXXXXXX
"amount": 20.01,
"customer": {
“external_id": “CUS00001“
"phone": "+19999999",
"name": "Juan Perez", ID unico en sistemas del Empresa
"email": "juan.perez1111@kashio.net",
Generado al usar Basic Authentication "document_type": “OTHER",
username = kashio_api_key "document_id": “CUS000001"
password = _blank },
"metadata": {
"order_id" : "001-123456",
"order_name" : “Cuota ENE2019",
"order_description" : "Pago de Cuota Enero 2019"
}
}

1
Empresa KashIO

© KashIO 2021 - Privileged/Confidential Information WWW.KASHIO.NET

 2. Notificación de Pago
A través de los procesos Webhook, KashIO puede notificar en tiempo real diferentes eventos que ocurren en
la plataforma de KashIO, como pagos, liquidaciones, etc.
El webhook de KashIO consiste en una llamada POST al servicio listener del Empresa con un Payload
detallando el tipo de evento.
{
POST https://empresa.com/listener/kashio "id": "eve_6hxCf5yj6jAHep3JUJZrmm", ID de la deuda generado por KashIO en
accept: application/json "object": "event", el paso 1
content-type: application/json "livemode": false,
authorization: Basic XXXXXX "created": "2017-01-31T14:24:59",
"type": "invoice.paid",
"data": {
"url": "//invoices/inv_QokikJOvBiI2HlWgH4olfQ2",
"invoice": {
"id": "inv_QokikJOvBiI2HlWgH4olfQ2",
"object": "invoice"
}
},
"status": "new"
}

2
KashIO Empresa

Respuesta de Empresa debe ser HTTP 200 caso contrario

KashIO volverá a reintentar la notificación 10 veces cada
3min

© KashIO 2021 - Privileged/Confidential Information WWW.KASHIO.NET

 3. Notificación de Liquidación
A través de los procesos Webhook, KashIO puede notificar en tiempo real diferentes eventos que ocurren en
la plataforma de KashIO, como pagos, liquidaciones, etc.
El webhook de KashIO consiste en una llamada POST al servicio listener del Empresa con un Payload
detallando el tipo de evento.
{
POST https://empresa.com/listener/kashio "id": "eve_6hxCf5yj6jAHep3JUJZrmm", • ID de la LIQUIDACION generado por
accept: application/json "object": "event",
"livemode": false, KashIO
content-type: application/json
authorization: Basic XXXXXX "created": "2017-01-31T14:24:59", • Con este ID se pude consultar la
"type": “settlement.confirmed", operacion LIQUDACION (settlement)
"data": {
"url": "//settlements/set_live_HS8BHPtuoYoSTMQFCSzxxzx", y los pagos y comisiones incluidas.
"invoice": {
"id": "set_live_HS8BHPtuoYoSTMQFCSzxxzx",
"object": “settlement"
}
},
"status": "new"
}

2
KashIO Empresa

Respuesta de Empresa debe ser HTTP 200 caso contrario

KashIO volverá a reintentar la notificación 10 veces cada
3min

© KashIO 2021 - Privileged/Confidential Information WWW.KASHIO.NET

 POSTMAN
Tester de KashIO API
Archivo POSTMAN, puede ser importado para pruebas, lo único necesario
es cambiar el ApiKey generado por KashIO desde su consola

POSTMAN TESTER
https://www.kashio.net/developer/kashio_payments_postman.json

© KashIO 2021 - Privileged/Confidential Information WWW.KASHIO.NET

Herramientas

1. Documentacion general de KashIO Payments API

https://www.kashio.net/docs/api/index.html

2. Probador REST/JSON
Sugerimos POSTMAN https://www.getpostman.com para todo el proceso de pruebas.

3. KCMS (KashIO Customer Management System)

Certificación https://cert-kpms.kashio.net
Producción https://kpms.kashio.net

4. Webhook Tester
https://webhook.site/

5. Probador de Pagos de Deuda (solo certificación):

Llamada POST a :
https://ue4c3n72il.execute-api.us-east-1.amazonaws.com/CERT/pay-invoice
{
"invoice_id": "{invoice.id}"
}

© KashIO 2021 - Privileged/Confidential Information WWW.KASHIO.NET

 CONTACTO

Perú

Gracias
KashIO Peru SAC
Av. Paseo de la República N° 5895
Piso 11 Edificio Leuro – Miraflores.
Lima – PERU
Central : +511 748 5105
Email : informes@kashio.net

USA
KashIO INC
80 SW 8th St, Suite 2000
Miami FL 33130 – USA
Phone : +1-305-507-8868
Email: info@kashio.net