Ejemplos específicos Pago de suscripciones / Pagos Exprés

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.

Ejemplo 1: Pago con petición de nuevo identificador

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:

• Ds_Merchant_MerchantCode=327234688
• Ds_Merchant_Terminal=1
• Ds_Merchant_Currency=978
• Ds_Merchant_TransactionType=0
• Ds_Merchant_Amount=100
• Ds_Merchant_Order=112545
• Ds_Merchant_Identifier=REQUIRED
• Ds_Merchant_MerchantURL=<URL de notificació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:

• Ds_Merchant_Identifier=a091f0f9f0aaf0506930 dda4a6974f1df4a0d9c1
• Ds_ExpiryDate=2012

Ejemplo 2: Pago con identificador

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:

• Ds_Merchant_MerchantCode=327234688
• Ds_Merchant_Terminal=1
• Ds_Merchant_Currency=978
• Ds_Merchant_TransactionType=0
• Ds_Merchant_Amount=100
• Ds_Merchant_Order=112546<No debe ser el mismo de la operación original>
• Ds_Merchant_Identifier=a091f0f9f0aaf0506930 dda4a6974f1df4a0d9c1
• Ds_Merchant_MerchantURL=<URL de notificación>

Ejemplo 3: Pago con petición de nuevo identificador y código de grupo

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:

• Ds_Merchant_MerchantCode=327234688
• Ds_Merchant_Terminal=1
• Ds_Merchant_Currency=978
• Ds_Merchant_TransactionType=0
• Ds_Merchant_Amount=100
• Ds_Merchant_Order=112545
• Ds_Merchant_Identifier=REQUIRED
• Ds_Merchant_Group=777888991
• Ds_Merchant_MerchantURL=<URL de notificació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:

• Ds_Merchant_Identifier=a091f0f9f0aaf0506930dda4a6974f1df4a0d9c1
• Ds_ExpiryDate=2012

Ejemplo 4: Pago con identificador asociado a un grupo

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:

• Ds_Merchant_MerchantCode=327234688
• Ds_Merchant_Terminal=1
• Ds_Merchant_Currency=978
• Ds_Merchant_TransactionType=0
• Ds_Merchant_Amount=100
• Ds_Merchant_Order=112546
• Ds_Merchant_Identifier=a091f0f9f0aaf0506930dda4a6974f1df4a0d9c1
• Ds_Merchant_Group=777888991
• Ds_Merchant_MerchantURL=<URL de notificación>

Ejemplo 5: Pago con identificador y flag para no mostrar pantallas

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:

• Ds_Merchant_MerchantCode=327234688
• Ds_Merchant_Terminal=1
• Ds_Merchant_Currency=978
• Ds_Merchant_TransactionType=0
• Ds_Merchant_Amount=100
• Ds_Merchant_Order=112546 <No tiene que ser el mismo de la operación original>
• Ds_Merchant_Identifier=a091f0f9f0aaf0506930dda4a6974f1df4a0d9c1
• Ds_Merchant_MerchantURL=<URL de notificación>
• Ds_Merchant_DirectPayment=true

Ejemplo 6: Pago con petición de nuevo identificador por entrada Web Service

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:

• XML

<REQUEST>
<DATOSENTRADA>
<DS_MERCHANT_AMOUNT>100</DS_MERCHANT_AMOUNT>
<DS_MERCHANT_ORDER>1473846837</DS_MER­CHANT_ORDER>
<DS_MERCHANT_MERCHANTCODE>327234688</DS_MERCHANT_MERCHANTCODE>
<DS_MERCHANT_CURRENCY>978</DS_MERCHANT_CUR­RENCY>141 
<DS_MERCHANT_PAN>4548812049400004</DS_MER­CHANT_PAN> 
<DS_MERCHANT_EXPIRYDATE>2012</DS_MERCHANT_EX­PIRYDATE> 
<DS_MERCHANT_CVV2>533</DS_MERCHANT_CVV2> 
<DS_MERCHANT_TRANSACTIONTYPE>A</DS_MERCHANT_ TRANSACTIONTYPE> 
<DS_MERCHANT_TERMINAL>2</DS_MERCHANT_TER­MINAL> 
<DS_MERCHANT_IDENTIFIER>REQUIRED</DS_MER­CHANT_IDENTIFIER> 
</DATOSENTRADA> 
<DS_SIGNATUREVERSION>HMAC_SHA256_V1</DS_SIG­NATUREVERSION> 
<DS_SIGNATURE>0HMBHIDZY/LZHS5YJTMTUTSUQWSG­WOOBOPW5BPSFI5E=</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:

• XML

<RETORNOXML> 
<CODIGO>0</CODIGO> 
<OPERACION> 
<DS_AMOUNT>100</DS_AMOUNT> 
<DS_CURRENCY>978</DS_CURRENCY> 
<DS_ORDER>1473846837</DS_ORDER> 
<DS_SIGNATURE>HLKRCQPRW5DE7EFKRULD9QXLS5K7PLV­LX2CFWNNCQO4=</DS_SIGNATURE> 
<DS_MERCHANTCODE>327234688</DS_MERCHANT­CODE> 
<DS_TERMINAL>2</DS_TERMINAL> 
<DS_RESPONSE>0000</DS_RESPONSE> 
<DS_AUTHORISATIONCODE>229360</DS_AUTHORISATION­CODE> 
<DS_TRANSACTIONTYPE>A</DS_TRANSACTIONTYPE> 
<DS_SECUREPAYMENT>0</DS_SECUREPAYMENT> 
<DS_LANGUAGE>1</DS_LANGUAGE> 
<DS_EXPIRYDATE>2012</DS_EXPIRYDATE> 
<DS_MERCHANT_IDENTIFIER>DE021281B7303F­3C3B2083A2BB150C21E6574946</DS_MERCHANT_IDEN­TIFIER> 
<DS_MERCHANTDATA></DS_MERCHANTDATA> 
<DS_CARD_COUNTRY>724</DS_CARD_COUNTRY> 
</OPERACION> 
</RETORNOXML>

Ejemplo 7: Pago usando un identificador por entrada Web Service

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:

• XML

<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:

• XML

<REQUEST>
<DATOSENTRADA>
<DS_MERCHANT_AMOUNT>100</DS_MERCHANT_AMOUNT>
<DS_MERCHANT_ORDER>1473847697</DS_MERCHANT_ORDER>
<DS_MERCHANT_MERCHANTCODE>327234688</DS_MER­CHANT_MERCHANTCODE>
<DS_MERCHANT_CURRENCY>978</DS_MERCHANT_CUR­RENCY>
<DS_MERCHANT_PAN>4548812049400004</DS_MER­CHANT_PAN>
<DS_MERCHANT_EXPIRYDATE>2012</DS_MERCHANT_EX­PIRYDATE>
<DS_MERCHANT_CVV2>123533</DS_MERCHANT_CVV2>
<DS_MERCHANT_TRANSACTIONTYPE>A</DS_MERCHANT_TRANSACTIONTYPE>
<DS_MERCHANT_TERMINAL>2</DS_MERCHANT_TERMI­NAL>
<DS_MERCHANT_IDENTIFIER>DE021281B7303F­3C3B2083A2BB150C21E6574946</DS_MERCHANT_IDEN­TIFIER>
</DATOSENTRADA>
<DS_SIGNATUREVERSION>HMAC_SHA256_V1</DS_SIGNA­TUREVERSION>
<DS_SIGNATURE>GKPI63NIDOE7NKK+NVVLUVQYW­WDHYQBWMVCQKOHTV6I=</DS_SIGNATURE>
</REQUEST>