Ver documento Parámetros de Entrada y salida
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:
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>
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>
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>
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>
Las peticiones Host to Host 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:
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>