I.V.R. Integration

Introduction

The purpose of this annex is to serve as a reference during the integration process of a business with the PAYCOMET payment gateway, using the default integration system, collecting card information through IVR. interactive voice response systems.

Except for some exceptions detailed in this document (authorised operations, signature calculations in XML integrations), all documentation relating to default integration is fully valid for implementation through IVR.

Take a look at that documentation for obtaining an overview of the purchase process and different inflows and outflows

Web programming

The technologies used for the operation with the PAYCOMET payment Gateway are SOAP (XML) and REST, both based on HTTPS to avoid transport problems through firewalls and other devices, while guaranteeing the security of operations. There is very broad support for carrying out SOAP and REST calls for the main programming languages used in web environments.

Requests are made through the HTTPS transport protocol, so it must be ensured that your system is capable of creating the requests correctly and managing the security certifications returned by the platform for correct use.

There are several operations which can be launched from the same service.
The operations available are described below:

IVR session request

Method: get_ivr_session

To start a conversation with the IVR system, it is necessary to first make the following call in which the start of the session will be established.

Select the type of integration:

Check of IVR session status

Method: get_ivr_sessionstate

This method allows the collection of information on the state of an IVR session.

Select the type of integration:

Bis Check of IVR HTTP POST session status

Additionally, to facilitate the operation of recovering information from an IVR session, for example through ajax, it is possible to make the call directly through POST.

The URL is the following: https://api.paycomet.com/gateway/post_ivr.php

The parameters which must be sent are the following:

The response is described in the following table:

Example of javascript call:

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);
                }
        });
}
                        
                

Additional configuration

In the section (Terminals->"Terminal name"->IVR ) you will find the configuration options:

• Maximum number of attempts

• Return extension if timed out

• Return extension if successful

• Return extension if failure

Appendix I - Operation types

The types of operations authorised in the IVR integration are the following:

Appendix II – Currencies

The codes of currencies in which operations may be carried out is detailed at section Currencies