Nuestra API está construido bajo los estándares de REST. Es decir, posee URLs orientadas a recursos. Cada petición a la API retorna un objeto JSON incluyendo errores.
Para que puedas comenzar a experimentar con nuestras APIs debes contar con un acceso, todas las cuentas registradas en Kashio poseen unas credenciales y unas llaves (API KEY) para los ambientes tanto de certificación como de producción.
Si esta usando el ambiente de certificación las transacciones no pasan por las redes bancarias, pero tenemos un simulador de pagos que le ayudara a cerrar el flujo de pago.
Nunca debes exponer tu API KEY (llave secreta) bajo ningún motivo.
Ambiente de Certificación vs Producción
Uno es el ambiente para hacer pruebas y otro para realizar transacciones reales.
| Ambiente | Descripción del Ambiente |
|---|---|
| Producción | Te permite realizar transacciones reales. |
| Certificación | Te permite realizar transacciones de prueba simulando el pago y notificación. |
Ambos funcionan exactamente igual, con la diferencia que el ambiente de certificación solo es para realizar la integración sin exponer las transacciones a la red bancaria.
Autenticamos nuestros servicios usando BASIC AUTHENTICATION, usando solo el ApiKey como username.
A continuación mostramos las URLs de los endpoints por ambiente:
| Ambiente | Endpoint |
|---|---|
| Producción | https://api.kashio.net/v1/ |
| Certificación | https://cert-api.kashio.net/v1/ |
Estandares de Datos Usados
| Formato | ISO | Ejemplo |
|---|---|---|
| Character encoding | Unicode UTF-8 | |
| Fecha y Hora | ISO 8601 (yyyy-MM-ddThh:mm:ss). Timezone en GMT | 2007-01-31T14:24:59 |
| Monedas | ISO 4217 alpha-3 | USD, PEN |
| Idiomas | ISO 639-1 | EN, ES, DE |
| Paises | ISO 3166-1-alpha-3 | USA, PER |
| Teléfonos | E.164 | +51997220000 |