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 banco. De forma estándar: 1 – Operaciones en euros (Ds_Merchant_Currency= 978) En caso de querer más terminales se pueden solicitar al servicio técnico de Banco Sabadell.
Número de pedido	Ds_Merchant_Order	Mín. 4N Máx. 12 AN Para “Tarjeta en Archivo” el campo debe ser máx. 10 posiciones, ya que el TPV Virtual añadirá 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_Currency	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_ ProductDescription	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_Titular	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_UrlOK	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_UrlKO	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_ConsumerLanguage	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_AuthorisationCode	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_DirectPayment	'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.

Servicio de Atención al Cliente Información a clientes MIFID Aviso legal Política de privacidad Política de cookies Seguridad

Banco de Sabadell, S.A. con domicilio social en Avenida Óscar Esplá, 37 - 03007 Alicante. Inscrito en el Registro Mercantil de Alicante Tomo 4070 Folio 1 Sección 8 Hoja A-156980 y NIF A-08000143.

Entidad de crédito sujeta a la supervisión del Banco de España e inscrita en el Registro administrativo especial con el número 0081.