INTEGRACION API

 
 

 
 
 
SMI ofrece una API que le permite a tu comercio procesar transacciones desde diferentes tipos de aplicaciones (web, móvil, IVR, entre otras).

A través de nuestro sitio web o establecer contacto directo con uno de nuestros asesores a través de whatsapp, líneas telefónicas, skype o chat.

API checkout
 
 

Funcionalidades disponibles para la integración con la API SMI

Integración API

Consultas

Configuraciones iniciales

Con APISMI puedes realizar integraciones usando nuestra pasarela transaccional, la cual te da acceso a herramientas de pago y consultas, desarrollando un cliente HTTPS para transferir la información de las transacciones
El intercambio de mensajes se realiza a través de cadenas XML o JSON, las operaciones se distinguen a través de un comando que se envía en la petición. Un ejemplo de una petición en XML y una en JSON se pueden ver en los siguientes listados:

									POST /smi-api/4.0/service.cgi HTTP/1.1 
									Host: api.segurosmedicosinternacionales.com.co
									Content-Type: application/xml; charset=utf-8
									Accept: application/xml
									Content-Length: length
                                        <request>
                                        <language>en</language>
									   <command>GET_COTIZACIONES_METHODS</command>
									   <merchant>
										  <apiLogin>xxxxxxxxxxxxx</apiLogin>
										  <apiKey>xxxxxxxxxxxxx</apiKey>
									   </merchant>
									   <isTest>false</isTest>
									</request>
									
									POST /smi-api/4.0/service.cgi HTTP/1.1 
									Host: api.segurosmedicosinternacionales.com.co
									Content-Type: application/json; charset=utf-8
									Accept: application/json
									Content-Length: length
									{
									   "test": false,
									   "language": "en",
									   "command": "GET_PAYMENT_METHODS",
									   "merchant": {
									      "apiLogin": "xxxxxxxxxxxxx",
									      "apiKey": "xxxxxxxxxxxxx"
									   }
									}
 
 

Puedes definir en la petición qué lenguajes deseas usar a través de las cabeceras HTTP Content-type y Accept. Se pueden usar todas las combinaciones posibles:

 
CONTENT-TYPE ACCEPT
application/xml application/xml
application/json application/json
application/xml application/json
application/json application/xml
 
 
 
Tener en cuenta:
  1. Debes tener una cuenta de Intermediario en Seguros Medicos Internacionales.
  2. Debes contar con lenguajes de servidor o CGI tales como Java, C#, VB, PHP, etc.
  3. Debes estar en capacidad de almacenar de forma segura tus credenciales de autenticación (API Key y API Login).
  4. La codificación para los mensajes debe ser UTF-8.
  5. Las fechas con hora deben seguir el formato yyyy-MM-ddTHH:mm:ss, el formato de la hora es 24 horas. Ej. 2015-08-22T21:35:12.
  6. En condiciones normales la conexión garantiza tiempos de respuesta de 3 segundos en promedio, si hay una situación anormal, el tiempo máximo de respuesta será de 1 minuto. Es altamente recomendable que configures los "timeouts" cuando te conectes con SMI.