TPV Virtual - Datos del formulario de pago

Datos del formulario de pago

 

A continuación se indican los datos que deberá contener el formulario de pago:

DATO NOMBRE DEL CAMPO COMENTARIOS
Versión de firma Ds_SignatureVersion Constante que indica la versión de firma que se está utilizando.
Datos de la operación Ds_MerchantParameters Cadena en formato JSON con todos los parámetros de la petición codificada en Base 64.
Firma Ds_Signature Resultado del HMAC SHA256 de la cadena JSON codificada en Base 64 enviada en el parámetro anterior.

 

Para la creación del campo Ds_MerchantParameters, deberán utilizarse todos los campos marcados como obligatorio en la tabla que se muestra a continuación. El resto de campos son opcionales y podrán incluirse si el comercio lo desea.

 

DATO NOMBRE DEL CAMPO LONGITUD COMENTARIOS

Número de comercio

Código FUC

Ds_Merchant_MerchantCode 9 N Obligatorio
Código fijo asignado por Banco Sabadell.
Número de terminal Ds_Merchant_Terminal 3 N

Obligatorio

Número de terminal que le asignará su ban­co.

De forma estándar:
1 – Operaciones en euros (Ds_Merchant_Cu­rrency= 978)
En caso de querer más terminales se pueden solicitar al servicio técnico de Banco Sabadell.

Número de pedido Ds_Merchant_Or­der

Mín. 4N

Máx. 12 AN

 

Para “Tarjeta en Archi­vo” el campo debe ser máx. 10 posiciones, ya que el TPV Virtual aña­dirá 2 posiciones más para indicar el número de orden

Obligatorio

Los 4 primeros dígitos deben ser numéricos. Para los dígitos restantes, sólo utilizar los siguientes caracteres ASCII:


Del 30=0 al 39=9

Del 65=A al 90=Z

Del 97=a al 122=z


El código ha de ser diferente de transacciones anteriores.

Importe

Ds_Merchant_Amount

12 N Obligatorio
Las dos últimas posiciones se consideran decimales, excepto en Yenes.
Moneda Ds_Merchant_Cu­rrency 4 N

Obligatorio

978 – EURO
840 – USD
826 – GBP
392 – JPY

Ver tabla: Códigos ISO divisas

Tipo de transacción Ds_Merchant_ TransactionType 1 N

Obligatorio

0 - Pago estándar
1 - Preautorización
2 - Confirmación de Preautorización
3 - Devolución parcial o total
7 - Autenticación
8 - Confirmación de Autenticación
9 - Anulación de Preautorización
L - Tarjeta en Archivo Inicial
M - Tarjeta en Archivo Sucesiva
O - Preautorización Diferida
P - Confirmación de Preautorización Diferida
Q - Anulación de Preautorización Diferida

Descripción del Producto Ds_Merchant_ ProductDescrip­tion Máx. 125 AN

Opcional: Este campo se mostrará al titular en la pantalla de confirmación de la compra.

Nombre y apellidos del titular Ds_Merchant_Ti­tular Máx. 60 AN Opcional: Este campo se mostrará al titular en la pantalla de confirmación de la compra.
URL Ds_Merchant_ MerchantURL 250 AN

Obligatorio si el comercio tiene notificación “online”

URL del comercio que recibirá una comunicación en segundo plano (vía post) con los datos de la transacción.

URL OK Ds_Merchant_Ur­lOK 250 AN Opcional: URL donde se redirigirá al titular cuando pulse en el botón “Continuar” o “Cerrar”, una vez la operación haya finalizado.
URL KO Ds_Merchant_Ur­lKO 250 AN Opcional: URL donde se redirigirá al titular cuando pulse en el botón “Continuar” o “Cerrar”, una vez la operación haya finalizado.
Nombre del comercio Ds_Merchant_ MerchantName 25 AN Opcional: Será el nombre del comercio que aparecerá en la página de pago del cliente, si lo hubiera.
Idioma del titular     Ds_Merchant_ConsumerLan­guage 3 N

Opcional

0 – Cliente
1 – Castellano
2 – Inglés
3 – Catalán
4 – Francés
5 – Alemán
6 – Holandés
7 – Italiano
8 – Sueco
9 – Portugués
10 – Valenciano
11 – Polaco
12 – Gallego
13 – Euskera

Datos del comercio Ds_Merchant_MerchantData 1024 AN Opcional: Información libre del comercio para ser recibida en la respuesta online (vía URL o e-mail).
Código de autorización Ds_Merchant_Authorisation­Code 6 N Opcional: Código de autorización
Identificador Ds_Merchant_Identifier Max. 40 AN

Campo exclusivo de pago por referencia

El valor del campo es obligatorio para el primer pago.
Para segundo pago y sucesivos, el valor será el identificador que el Banco ha facilitado en el mensaje de respuesta del primer pago.

Grupo de comercios Ds_Merchant_Group Max. 9 N

Campo exclusivo de pago por referencia

Opcional: Permite asociar una referencia a un conjunto de comercios.

Pantallas adicionales Ds_Merchant_Di­rectPayment 'True' o 'False'

Campo exclusivo de pago por referencia

Opcional: Este parámetro funciona como un flag que indica si deben o no deben mostrarse pantallas adicionales (DCC, Fraccionamiento, Autenticación, etc.)

 

A continuación se describen los campos relacionados con los datos de la tarjeta, dada la posibilidad de que puedan ser capturados por el comerciante. Estos nuevos campos sólo tendrán que ser enviados por los comerciantes que capturan los datos de la tarjeta (Esta posibilidad comporta el cumplimiento de los requisitos del programa de seguridad de PCI-DSS, tal como se describe en este apartado del manual de TPV Virtual PLUS).

 

DATO NOMBRE DEL CAMPO LONGITUD COMENTARIOS
Número de tarjeta Ds_Merchant_Pan 16-19 N Obligatorio para todas las operaciones, excepto para aquellas que no necesiten de datos de tarjeta, como las confirmaciones o devoluciones.
Fecha de caducidad Ds_Merchant_ExpiryDate 4 N Obligatorio para todas las operaciones, excepto para aquellas que no necesiten de datos de tarjeta, como las confirmaciones o devoluciones.
CVV2 Ds_Merchant_CVV2 3 N Opcional: Código CVV2/CVC2 de la tarjeta enviada (*)

(*) Los tipos de transacciones 2 / 3 / 6 / 8 / 9 / P / Q no requieren que se informe el número de tarjeta, fecha de caducidad y CVV2.
En estos casos, el campo (Ds_Merchant_Order) debe ser el mismo de la transacción original.