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: |
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 65=A al 90=Z Del 97=a al 122=z
|
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 Ver tabla: Códigos ISO divisas |
Tipo de transacción | Ds_Merchant_ TransactionType | 1 N |
Obligatorio 0 - Pago estándar |
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 |
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. |
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.