Analizar el archivo de respuesta (ANS)

Existen dos categorías de errores:

  • Los errores de formato y/o de valores de los campos.
  • Los errores relacionados con la ejecución de los pagos.

El procesamiento por la plataforma se divide en dos fases:

  • En la primera fase se verifica la integridad del archivo y se detectan los errores de formato y/o de valores. En caso de error, el archivo se rechaza por completo.

    En esta primera fase se verifica el archivo de manera general. Los errores en los registros de detalles son procesados en la segunda fase.

  • En la segunda fase se realizan los pagos, línea por línea. En caso de error en uno de los parámetros (por ejemplo, identificador no encontrado, moneda incorrecta, etc.), se asignará el valor 30 al código de procesamiento en el registro de detalles y un campo complementario indicará la posición de los datos en cuestión. En caso de pago denegado, el motivo del rechazo se indicará en el registro de detalles.

En el primer caso, el archivo de resultados contendrá un solo registro de encabezado, en el que se indicará el incidente, y un registro de fin. El vendedor tendrá que corregir el archivo y cargarlo nuevamente, cambiando el nombre del archivo intercambiado.

En el segundo caso, el archivo de resultados contendrá el mismo número de registros de detalles que el archivo de solicitud. El vendedor solo deberá volver a cargar los pagos en los que ha habido un error en uno de los parámetros.

Si se produce un fallo en el funcionamiento y que la plataforma no puede procesar el archivo de forma oportuna, los pagos pendientes se llevarán a cabo cuando se restablezca el servicio. Por lo tanto, no hace falta cargar los pagos no procesados en un archivo nuevo.

Aquí tenemos la respuesta a nuestro archivo de prueba 20161130.12345678.PAY.REQ.T.01

El nombre del archivo de respuesta es 20161130.12345678.PAY.ANS.T.01.

Su contenido es el siguiente:

00;PAY;02;0;;12345678;TEST;20161130;102008;20140922;141349
02;1;20161130;102008;000001;CD;3299;840;20140922;0;MI-IDENTIFICADOR-TEST-1;
FR7630002005701234567890158;;;;;00;0;;FULL;20140922;141350;00;
FR7630002005701234567890158_CRLYFRPP;20170922
02;2;20161130;102008;000002;CD;790;840;20140922;0;MI-IDENTIFICADOR-TEST-1;
FR7630002005701234567890158;;;;;00;0;;FULL;20140922;141351;00;
FR7630002005701234567890158_CRLYFRPP;20170922
01;2;2;0

Formato del registro de encabezado:

Pos. Descripción Formato Valores Equivalencia en el diccionario de datos
01 Código de registro n2 00  
02 Tipo de archivo   PAY  
03 Versión del archivo n2 02  
04 Código de retorno de la primera fase del procesamiento n1

0 : Procesamiento realizado

1 : Error de formato

2 : Error de valores

 
05 Información sobre el error ans..255 Información adicional sobre el error, el blanco si la verificación fue exitosa.  
06 Identificador de la tienda n8 Igual que en la solicitud, si es válido. vads_site_id
07 Entorno   Igual que en la solicitud, si es válido. vads_ctx_mode
08 Fecha de creación n8 Igual que en la solicitud, si es válido.  
09 Hora de creación n6 Igual que en la solicitud, si es válido.  
10 Fecha de fin de procesamiento

En formato AAAAMMDD

n8 20161130  
11 Hora de fin de procesamiento n6 130019  

Formato de los registros de detalles:

Pos. Descripción Formato Valores Equivalencia en el diccionario de datos
01 Código de registro n2 02  
02 Número de secuencia n..6 Igual que en la solicitud  
03 Fecha de la transacción (igual que en la solicitud) n8 Igual que en la solicitud vads_trans_date
04 Hora de la transacción (igual que en la solicitud) n6 Igual que en la solicitud vads_trans_date
05 Identificador de la transacción (igual que en la solicitud) n..6 Igual que en la solicitud vads_trans_id
06 Tipo de transacción (igual que en la solicitud) a2 CD  
07 Monto (igual que en la solicitud) n..12 Igual que en la solicitud vads_amount
08 Moneda n3 Igual que en la solicitud vads_currency
09 Monto en contravalor en euros n..12 Igual que en la solicitud vads_effective_amount
10 Moneda de contravalor n3 Igual que en la solicitud  
11 Fecha solicitada de captura n8 Igual que en la solicitud  
12 Modo de validación n1

0 si validación automática

1 si validación manual

vads_validation_mode
13 Identificador de tarjeta ans..50 Igual que en la solicitud vads_identifier
14 Número de contrato n7 Número del contrato utilizado para procesar la solicitud  
15 Referencia del pedido ans..32 Igual que en la solicitud vads_order_id
16 Información de la transacción 1 ans..255 Igual que en la solicitud vads_order_info
17 Información de la transacción 2 ans..255 Igual que en la solicitud vads_order_info2
18 Información de la transacción 3 ans..255 Igual que en la solicitud vads_order_info3
19 Código de retorno del procesamiento  
Ejemplos:
  • 00: Procesamiento exitoso – Pago aceptado
  • 05: Procesamiento exitoso – Pago rechazado
  • 30: Error de parámetro.

    Información adicional disponible en el campo 25.

  • 96: Error técnico
vads_result
20 Código de retorno de autorización an..2

Valor devuelto por el servidor de autorización.

Consulte la lista de códigos en el capítulo Diccionario de datos.

En blanco si no aplica.

vads_auth_result
21 Número de autorización devuelto por el adquiriente. n6 no aplicable vads_auth_number
22 Modo de autorización   FULL vads_auth_mode
23 Fecha de autorización n8 En formato AAAAMMDD  
24 Hora de autorización n6 En formato HHMMSS  
25 Código de retorno complementario ans..255 Contiene el retorno del módulo de control de riesgos (si está suscrito) o la posición del campo erróneo en caso de error 30.

Consulte la lista de códigos en el capítulo Diccionario de datos.

En blanco si no aplica.

vads_extra_result
26 Número del medio de pago (n.° de tarjeta o n.° IBAN y BIC an..36 Extracto del número del medio de pago. (Ejemplo: IBAN_BIC)

El BIC es opcional, por lo que el número puede ser solo el IBAN.

vads_card_number
27 Fecha de vencimiento n8 En formato AAAAMMDD. En blanco si no aplica  

Formato del registro de fin:

Pos. Descripción Formato Valores
01 Código de registro n2 01
02 Número total de registros de detalles transmitidos n..6  
03 Número de pagos exitosos n..6  
04 Número de pagos fracasados n..6