Parámetros de Entrada y Salida

 

Ver documento Parámetros de Entrada y salida

 

Parámetros de la solicitud

 

En la petición de pago hacia el TPV Virtual SIS se tendrán que enviar una serie de parámetros obligatorios y otros opcionales, que irán en función del tipo de operación y operativa que se desee realizar.

En los siguientes puntos se mostrarán algunos ejemplos de peticiones WebService SOAP:

 

Petición de pago/preautorización (con envío de datos de tarjeta)

A continuación, se muestra un ejemplo de un mensaje de petición de pago:

<DATOSENTRADA>
<DS_MERCHANT_AMOUNT>145</DS_MERCHANT_AMOUNT>
<DS_MERCHANT_ORDER>050911523002</DS_MERCHANT_ORDER>
<DS_MERCHANT_MERCHANTCODE>999008881</DS_MERCHANT_MERCHANTCODE>
<DS_MERCHANT_CURRENCY>978</DS_MERCHANT_CURRENCY>
<DS_MERCHANT_PAN>XXXXXXXXXXXXX</DS_MERCHANT_PAN>
<DS_MERCHANT_CVV2>XXX</DS_MERCHANT_CVV2>
<DS_MERCHANT_TRANSACTIONTYPE>0</DS_MERCHANT_TRANSACTIONTYPE>
<DS_MERCHANT_TERMINAL>999</DS_MERCHANT_TERMINAL>
<DS_MERCHANT_EXPIRYDATE>XXXX</DS_MERCHANT_EXPIRYDATE>
</DATOSENTRADA>

 

Petición de Confirmación/Devolución/Anulación

A continuación, se muestra un ejemplo de un mensaje de petición de pago recurrente:

<DATOSENTRADA>
<DS_MERCHANT_AMOUNT>145</DS_MERCHANT_AMOUNT>
<DS_MERCHANT_ORDER>050911523002</DS_MERCHANT_ORDER>
<DS_MERCHANT_MERCHANTCODE>999008881</DS_MERCHANT_MERCHANTCODE>
<DS_MERCHANT_CURRENCY>978</DS_MERCHANT_CURRENCY>
<DS_MERCHANT_TRANSACTIONTYPE>3</DS_MERCHANT_TRANSACTIONTYPE>
<DS_MERCHANT_TERMINAL>999</DS_MERCHANT_TERMINAL>
</DATOSENTRADA>

Petición de Tokenización (Pago por Referencia - Pago 1-Clic)

A continuación, se muestra un ejemplo de un mensaje de petición de pago:

<DATOSENTRADA>
<DS_MERCHANT_AMOUNT>145</DS_MERCHANT_AMOUNT>
<DS_MERCHANT_ORDER>050911523002</DS_MERCHANT_ORDER>
<DS_MERCHANT_MERCHANTCODE>999008881</DS_MERCHANT_MERCHANTCODE>
<DS_MERCHANT_CURRENCY>978</DS_MERCHANT_CURRENCY>
<DS_MERCHANT_PAN>XXXXXXXXXXXXX</DS_MERCHANT_PAN>
<DS_MERCHANT_CVV2>XXX</DS_MERCHANT_CVV2>
<DS_MERCHANT_TRANSACTIONTYPE>0</DS_MERCHANT_TRANSACTIONTYPE>
<DS_MERCHANT_TERMINAL>999</DS_MERCHANT_TERMINAL>
<DS_MERCHANT_EXPIRYDATE>XXXX</DS_MERCHANT_EXPIRYDATE>
<DS_MERCHANT_IDENTIFIER>REQUIRED</ DS_MERCHANT_IDENTIFIER>
</DATOSENTRADA>

 

Petición de Tokenización (Pago por Referencia - Pago 1-Clic)

A continuación, se muestra un ejemplo de un mensaje de petición de pago:

<DATOSENTRADA>
<DS_MERCHANT_AMOUNT>145</DS_MERCHANT_AMOUNT>
<DS_MERCHANT_ORDER>050911523002</DS_MERCHANT_ORDER>
<DS_MERCHANT_MERCHANTCODE>999008881</DS_MERCHANT_MERCHANTCODE>
<DS_MERCHANT_CURRENCY>978</DS_MERCHANT_CURRENCY>
<DS_MERCHANT_TRANSACTIONTYPE>0</DS_MERCHANT_TRANSACTIONTYPE>
<DS_MERCHANT_TERMINAL>999</DS_MERCHANT_TERMINAL>
<DS_MERCHANT_IDENTIFIER>XXXXXXXXXXXXXXXXXXX</ DS_MERCHANT_IDENTIFIER>
</DATOSENTRADA>

 

 

Parámetros de la respuesta

 

Las peticiones REST generan una respuesta síncrona a la petición enviada por el comercio, en la cual se informará el resultado de la operación.

El resultado de la operación se informará mediante el parámetro Ds_Response o “Código de respuesta”, siempre y cuando el parámetro CODIGO tenga valor 0. Además, se informará dicho código de respuesta en la consulta de operaciones, siempre y cuando la operación no está autorizada, tal y como se muestra en la siguiente imagen:

 

Código de respuesta

 

Un ejemplo de respuesta de una operación de pago autorizada sería la siguiente:

<RETORNOXML>
<CODIGO>0</CODIGO>
<OPERACION>
<Ds_Amount>42</Ds_Amount>
<Ds_Currency>978</Ds_Currency>
<Ds_Order>12345ws</Ds_Order>
<Ds_Signature>nnrpj4Wqne4HbYriQ9Ik3E/Im9UovO+7TGVQ4fyE1pE=</Ds_Signature>
<Ds_MerchantCode>999008881</Ds_MerchantCode>
<Ds_Terminal>1</Ds_Terminal>
<Ds_Response>0000</Ds_Response>
<Ds_AuthorisationCode>492696</Ds_AuthorisationCode>
<Ds_TransactionType>0</Ds_TransactionType>
<Ds_SecurePayment>1</Ds_SecurePayment>
<Ds_Language>1</Ds_Language>
<Ds_CardNumber>454881******0003</Ds_CardNumber>
<Ds_ExpiryDate>****</Ds_ExpiryDate>
<Ds_Card_Type>C</Ds_Card_Type>
<Ds_MerchantData/>
<Ds_Card_Country>724</Ds_Card_Country>
<Ds_Card_Brand>1</Ds_Card_Brand>
</OPERACION>
</RETORNOXML>