VIRTUALVIEW

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

API checkout

Funcionalidades disponibles para la integración con la API

Consultas

Configuraciones iniciales

Con NETCO 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 /netco-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 /netco-api/4.0/service.cgi HTTP/1.1 
									Host: localhost
									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 contar con lenguajes de servidor o CGI tales como Java, C#, VB, PHP, etc.
  2. Debes estar en capacidad de almacenar de forma segura tus credenciales de autenticación (API Key y API Login).
  3. La codificación para los mensajes debe ser UTF-8.
  4. 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.
  5. 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.