El presente apartado recoge los ejemplos específicos de utilización de la funcionalidad Pago de Suscripciones / Pagos Exprés, para cada una de las modalidades de procesamiento de operaciones en el TPV Virtual de Banco Sabadell
A continuación se incluyen varios ejemplos basados en un comercio que utilice la entrada “realizarPago” al SIS.
Para generar un identificador nuevo se deberá realizar una petición de pago normal con el añadido de que se deberá añadir el parámetro Ds_Merchant_Identifier con el valor “REQUIRED” junto al resto de parámetros de la operación.
En la respuesta de la operación autorizada el comercio recibirá el identificador junto a la fecha de caducidad. El identificador estará asociado al comercio indicado por el parámetro Ds_Merchant_MerchantCode.
Datos a enviar en la petición:
Respuesta en notificación on-line
Si la operación es autorizada, la notificación On-Line y la URL OK incluirán los nuevos parámetros con el valor del identificador generado y la caducidad de la tarjeta a modo de caducidad del identificador. El resto de los campos de la notificación no varían ni tampoco el cálculo de su firma.
Un ejemplo de identificador sería el siguiente:
Para realizar un pago con un identificador ya generado, se deberá utilizar el mismo formulario que en el ejemplo anterior, con la diferencia de que en esta ocasión en el campo Ds_Merchant_Identifier se deberá indicar el identificador que se ha generado. En este caso, se podría usar el parámetro Ds_Merchant_DirectPayment con valor ‘true’ y el comportamiento sería el mismo.
Datos a enviar en la petición:
Se realiza un pago y se añade el parámetro Ds_Merchant_Identifier con el valor REQUIRED para que se genere un identificador nuevo y se devuelva en la notificación junto con la fecha de caducidad. El identificador estará asociado al grupo de comercios que se indique en el campo Ds_Merchant_Group.
Datos a enviar en la petición:
Respuesta en notificación on-line
Si la operación es autorizada, la notificación On-Line y la URL OK incluirán los nuevos parámetros con el valor del identificador generado y la caducidad de la tarjeta a modo de caducidad del identificador. El resto de los campos de la notificación no varían ni tampoco el cálculo de su firma.
Un ejemplo de identificador sería el siguiente:
Se hace un pago y se añade el parámetro Ds_Merchant_Identifier con el valor del identificador a utilizar y el campo Ds_Merchant_Group con el ID de grupo. En este caso, se podría usarse el parámetro Ds_Merchant_DirectPayment con valor ‘true’ y el comportamiento sería el mismo.
Datos a enviar en la petición:
Se hace un pago y se añaden los parámetros Ds_Merchant_Identifier con el valor del identificador a utilizar y Ds_Merchant_DirectPayment con el valor “true”.
Datos a enviar en la petición:
Se hace un pago y se añade el elemento XML<DS_MERCHANT_IDENTIFIER> con el valor REQUIRED para que se genere un identificador nuevo y se devuelva en la respuesta XML junto con la fecha de caducidad. La referencia estará asociada al grupo de comercios que se indique en el elemento<DS_MERCHANT_GROUP>, si se define. En la petición original no se debe enviar el elemento <DS_MERCHANT_DIRECTPAYMENT>.
XML de petición:
<REQUEST> <DATOSENTRADA> <DS_MERCHANT_AMOUNT>100</DS_MERCHANT_AMOUNT> <DS_MERCHANT_ORDER>1473846837</DS_MERCHANT_ORDER> <DS_MERCHANT_MERCHANTCODE>327234688</DS_MERCHANT_MERCHANTCODE> <DS_MERCHANT_CURRENCY>978</DS_MERCHANT_CURRENCY>141 <DS_MERCHANT_PAN>4548812049400004</DS_MERCHANT_PAN> <DS_MERCHANT_EXPIRYDATE>2012</DS_MERCHANT_EXPIRYDATE> <DS_MERCHANT_CVV2>533</DS_MERCHANT_CVV2> <DS_MERCHANT_TRANSACTIONTYPE>A</DS_MERCHANT_ TRANSACTIONTYPE> <DS_MERCHANT_TERMINAL>2</DS_MERCHANT_TERMINAL> <DS_MERCHANT_IDENTIFIER>REQUIRED</DS_MERCHANT_IDENTIFIER> </DATOSENTRADA> <DS_SIGNATUREVERSION>HMAC_SHA256_V1</DS_SIGNATUREVERSION> <DS_SIGNATURE>0HMBHIDZY/LZHS5YJTMTUTSUQWSGWOOBOPW5BPSFI5E=</DS_SIGNATURE> </REQUEST>
Respuesta XML
Si la operación es autorizada, el XML de respuesta incluirá los nuevos parámetros con el valor del identificador generado y la caducidad de la tarjeta a modo de caducidad de la referencia. En la notificación Online también se enviarán estos datos. El resto de los campos de la respuesta no varían ni tampoco el cálculo de su firma.
Un ejemplo de respuesta XML sería el siguiente:
<RETORNOXML> <CODIGO>0</CODIGO> <OPERACION> <DS_AMOUNT>100</DS_AMOUNT> <DS_CURRENCY>978</DS_CURRENCY> <DS_ORDER>1473846837</DS_ORDER> <DS_SIGNATURE>HLKRCQPRW5DE7EFKRULD9QXLS5K7PLVLX2CFWNNCQO4=</DS_SIGNATURE> <DS_MERCHANTCODE>327234688</DS_MERCHANTCODE> <DS_TERMINAL>2</DS_TERMINAL> <DS_RESPONSE>0000</DS_RESPONSE> <DS_AUTHORISATIONCODE>229360</DS_AUTHORISATIONCODE> <DS_TRANSACTIONTYPE>A</DS_TRANSACTIONTYPE> <DS_SECUREPAYMENT>0</DS_SECUREPAYMENT> <DS_LANGUAGE>1</DS_LANGUAGE> <DS_EXPIRYDATE>2012</DS_EXPIRYDATE> <DS_MERCHANT_IDENTIFIER>DE021281B7303F3C3B2083A2BB150C21E6574946</DS_MERCHANT_IDENTIFIER> <DS_MERCHANTDATA></DS_MERCHANTDATA> <DS_CARD_COUNTRY>724</DS_CARD_COUNTRY> </OPERACION> </RETORNOXML>
Se hace un pago y se añade el elemento XML <DS_MERCHANT_IDENTIFIER> con el valor de la referencia a utilizar. En este caso, se podría usar el elemento XML <DS_MERCHANT_DIRECTPAYMENT> con valor ‘true’ y no aplicaría DCC (en caso de haberlo).
XML de petición:
<REQUEST> <DATOSENTRADA> <DS_MERCHANT_AMOUNT>100</DS_MERCHANT_AMOUNT> <DS_MERCHANT_ORDER>1473847697</DS_MERCHANT_ORDER> <DS_MERCHANT_MERCHANTCODE>327234688</DS_MERCHANT_MERCHANTCODE> <DS_MERCHANT_CURRENCY>978</DS_MERCHANT_CURRENCY> <DS_MERCHANT_PAN>4548812049400004</DS_MERCHANT_PAN> <DS_MERCHANT_EXPIRYDATE>2012</DS_MERCHANT_EXPIRYDATE> <DS_MERCHANT_CVV2>533</DS_MERCHANT_CVV2> <DS_MERCHANT_TRANSACTIONTYPE>A</DS_MERCHANT_TRANSACTIONTYPE> <DS_MERCHANT_TERMINAL>2</DS_MERCHANT_TERMINAL> <DS_MERCHANT_IDENTIFIER>DE021281B7303F3C3B2083A2BB150C21E6574946</DS_MERCHANT_IDENTIFIER> </DATOSENTRADA> <DS_SIGNATUREVERSION>HMAC_SHA256_V1</DS_SIGNATUREVERSION> <DS_SIGNATURE>GKPI63NIDOE7NKK+NVVLUVQYWWDHYQBWMVCQKOHTV6I=</ DS_SIGNATURE> </REQUEST>
Respuesta XML
Si la operación es autorizada, el XML de respuesta incluirá también el parámetro con el valor del identificador enviado. En la notificación Online también se enviará este dato. El resto de los campos de la respuesta no varían ni tampoco el cálculo de su firma.
Un ejemplo de respuesta XML sería el siguiente:
<REQUEST> <DATOSENTRADA> <DS_MERCHANT_AMOUNT>100</DS_MERCHANT_AMOUNT> <DS_MERCHANT_ORDER>1473847697</DS_MERCHANT_ORDER> <DS_MERCHANT_MERCHANTCODE>327234688</DS_MERCHANT_MERCHANTCODE> <DS_MERCHANT_CURRENCY>978</DS_MERCHANT_CURRENCY> <DS_MERCHANT_PAN>4548812049400004</DS_MERCHANT_PAN> <DS_MERCHANT_EXPIRYDATE>2012</DS_MERCHANT_EXPIRYDATE> <DS_MERCHANT_CVV2>123533</DS_MERCHANT_CVV2> <DS_MERCHANT_TRANSACTIONTYPE>A</DS_MERCHANT_TRANSACTIONTYPE> <DS_MERCHANT_TERMINAL>2</DS_MERCHANT_TERMINAL> <DS_MERCHANT_IDENTIFIER>DE021281B7303F3C3B2083A2BB150C21E6574946</DS_MERCHANT_IDENTIFIER> </DATOSENTRADA> <DS_SIGNATUREVERSION>HMAC_SHA256_V1</DS_SIGNATUREVERSION> <DS_SIGNATURE>GKPI63NIDOE7NKK+NVVLUVQYWWDHYQBWMVCQKOHTV6I=</DS_SIGNATURE> </REQUEST>