Formato

Cada archivo debe estar compuesto por una serie de registros.

Se llama “registro” a una lista de parámetros separados por el carácter “;” y terminados por un retorno de carro.

Los archivos tienen la siguiente estructura:

  • Un registro de encabezado que proporciona información sobre la transmisión.
  • Un número variable de registros que corresponden cada uno a una solicitud de pago.

El registro de encabezado

Pos. Descripción Valores
01 Versión del encabezado 01
02 Identificador de la tienda 12345678
03 Modo TEST o PRODUCTION
04 Canal INVOICE

El registro de detalles

Pos. Descripción
01 Descripción: Define la operación a realizar.

Tipo: VARCHAR | Longitud: 32 | Opcional

Si el campo se envía vacío, se aplica por defecto el valor "PAYMENT".

Equivalente Formulario API: vads_page_action

Equivalente API REST: formAction

Valor posible: PAYMENT

02 Descripción: Referencia única de la factura.

Tipo: VARCHAR | Longitud: 94 | Obligatorio

El único carácter especial aceptado es el guion "-".

Equivalente Formulario API: vads_order_id

Equivalente API REST: orderId

Ejemplo: CX-1254

03 Descripción: Monto de la transacción expresado en la unidad más pequeña de la moneda.

Tipo: NUMERIC | Longitud: 13 | Obligatorio

El monto no se puede valorar en 0.

Equivalente Formulario API: vads_amount

Equivalente API REST: amount

Ejemplo: 3000 para 30,00 USD

04 Descripción: Código numérico de la moneda del pago, según la norma ISO 4217.

Tipo: NUMERIC | Longitud: 3 | Obligatorio

Debe corresponder a la moneda de la empresa.

Equivalente Formulario API: vads_currency

Equivalente API REST: currency

Ejemplo: 840 para el dólar norteamericano (USD) (Ver capitulo Lista de monedas aceptadas en anexos)

05

Descripción: Dirección de correo electrónico del comprador.

Tipo: VARCHAR | Longitud: 255 | Opcional

Equivalente Formulario API: vads_cust_email

Equivalente API REST: customer.email

Ej.: sample@example.net

06 Descripción: Modo de validación.

Tipo: NUMERIC | Longitud: 1 | Opcional

Equivalente Formulario API: vads_validation_mode

Equivalente API REST: cardOptions.manualValidation

Valores posibles:
  • 0: para una validación automática
  • 1: para una validación manual
  • En blanco: para utilizar el modo de validación predeterminado.

Ejemplo: 0

07 Descripción: Descripción de la factura que se abonará.

Tipo: VARCHAR | Longitud: 65 | Opcional

Equivalente Formulario API: vads_validation_mode

Equivalente API REST: description

Ejemplo: My order description

08 Descripción: Fecha de vencimiento de la solicitud de pago.

Tipo: NUMERIC | Longitud: 8 | Opcional

No puede ser anterior a la fecha actual ni superar los 90 días. Si este parámetro no está definido, se aplicará el valor de la tienda.

Equivalente Formulario API: N/A

Equivalente API REST: expirationDate

Ejemplo: 20210603

09 Descripción: Tasa de impuesto aplicada para todo el pedido. El valor debe ser el porcentaje a aplicar (21 para 21%).

Tipo: NUMERIC | Longitud: 4 | Opcional

Equivalente Formulario API: vads_tax_rate

Equivalente API REST: taxRate

Ejemplo: 5.5

10 Descripción: Preferencia vendedor relativa a la autentificación 3DS.

Tipo: VARCHAR | Longitud: 32 | Opcional

Si el campo se envía vacío, se aplica por defecto el valor "NO_REFERENCE".

Equivalente Formulario API: vads_threeds_mpi

Equivalente API REST: strongAuthentication

Valores posibles:
  • FRICTIONLESS:
  • NO_PREFERENCE:
  • CHALLENGE_MANDATE:

Ejemplo: NO_PREFERENCE

11 Descripción: Uso del formulario de recogida de datos.

Tipo: BOOLEAN | Longitud: 1 | Opcional

Se ignora este campo para una solicitud de pago de factura. El valor aplicado siempre es true.

Equivalente Formulario API: N/A

Equivalente API REST: dataCollectionForm

Valores posibles:
  • true
  • false

Ej: true

Ejemplo de archivo

01;12345678;TEST;INVOICE
PAYMENT;OrderRef-1;10000;978;sample@example.net;0;Order Description;20210518;;;