Integración I.V.R.

Introducción

La finalidad del presente anexo es servir de referencia durante el proceso de integración de un comercio con la pasarela de pagos PAYCOMET, utilizando el sistema de integración general, con captación de datos de tarjeta a través de sistemas de respuesta de voz interactiva IVR.

Salvo algunas excepciones que se detallan en este documento (operaciones permitidas, cálculos de firmas en la integración XML), toda la documentación relativa a la integración general es perfectamente válida para su realización a través de IVR.

Remítete a dicha documentación para obtener una visión general del proceso de compra y de las distintas entradas y salidas.

Programación Web

Las tecnologías disponibles para la operativa con la pasarela de pagos PAYCOMET son SOAP (XML) y REST, basadas en HTTPS para evitar problemas de transporte a través de firewalls y otros dispositivos y a la vez garantizar la seguridad de las operaciones. Existe un soporte muy amplio para la realización de amos tipos de llamadas para los principales lenguajes de programación usados en entornos web.

Las peticiones se realizan mediante el protocolo de transporte HTTPS, de manera que debes asegurarte de que su sistema es capaz de realizar las peticiones correctamente y gestionar los certificados de seguridad devueltos por la plataforma para una correcta utilización.

Existen varias operaciones que se podrán lanzar desde el mismo servicio.
Las operaciones disponibles vienen descritas a continuación:

Solicitud de sesión IVR

Método: get_ivr_session

Para iniciar una conversación con el sistema de IVR es preciso realizar con anterioridad la siguiente llamada en la que se establecerá el inicio de la sesión.

A continuación, selecciona el tipo de integración:

Comprobación de estado de sesión IVR

Método: get_ivr_sessionstate

Este método permite recabar información acerca del estado de una sesión IVR.

A continuación, selecciona el tipo de integración:

Bis Comprobación de estado de sesión IVR HTTP POST

Adicionalmente, para facilitar la operativa de rescatar la información de una sesión IVR, por ejemplo a través de ajax, es posible realizar la llamada directamente a través de POST.

La url es la siguiente: https://api.paycomet.com/gateway/post_ivr.php

Los parámetros que deberán enviarse son los siguientes:

La respuesta queda descrita en la tabla siguiente:

Ejemplo de llamada javascript:

function get_ivr_sessionstate() {
        var obj = {};
        obj.OPERATION= '1';
        obj.IVR_PROVIDER_ID= '**Identificador del proveedor/integrador IVR**';
        obj.IVR_MERCHANT_CODE= '**Código de cliente**';
        obj.IVR_MERCHANT_TERMINAL= '**Número de terminal**';
        obj.IVR_MERCHANT_ORDER= '**Referencia**';
        obj.IVR_PROVIDER_SIGNATURE= 'c292caae75bc62aaaaaaaaaaaaa655ead726471f';


        $.ajax({
                        type: "POST",
                        async: false,
                        url: "https://api.paycomet.com/gateway/post_ivr.php",
                        data: "getIVRData="+JSON.stringify(obj),
                        success: function(returnData){
                        var objR = JSON.parse(returnData);
                        console.log(objR);
                }
        });
}
                        
                

Configuración adicional

En la sección (Terminales->"Nombre de terminal"->IVR ) se encuentra las opciones de configuración:

• Número máximo de reintentos

• Extensión de retorno en caso de timeout

• Extensión de retorno en caso de éxito

• Extensión de retorno en caso de fallo

Anexo I - Tipos de operaciones

Los tipos de operaciones permitidos en la integración IVR son los siguientes:

Anexo II – Monedas

El lugar donde se detallan los códigos de las monedas en las que pueden realizarse las operaciones, está en el apartado Monedas