Formato

El registro « TITRE »

El registro TITRE informa sobre las características del archivo para permitir una mejor identificación. Se compone de la siguiente manera:

Pos. Descripción Valores
01 Código de registro TITRE
02 Nombre de la tienda
03 Fecha y hora UTC del envío (AA/MM/DD_hh:mm:ss) 20/01/13_01:55:00
04 Versión TABLE_V_CUSTOM

Los registros « ENTETE » y « DETAILS »

La línea ENTETE lista los diferentes nombres de los valores en el diario. Los datos de la línea DETAILS asignan un valor a los nombres del registro ENTETE, en cada transacción.

Por defecto, el informe de transacciones contiene los siguientes datos:

Pos. Descripción
01 ENTETE

Tipo: VARCHAR | Longitud: 11

Descripción: Código de registro.

Valor: Siempre será TRANSACTION

02 TRANSACTION_ID

Tipo: VARCHAR | Longitud: 6

Descripción: Identificador de la transacción.

Equivalente Formulario API: vads_trans_id

Equivalente API REST: cardDetails.legacyTransId

Ejemplo: xrT15p

03 MERCHANT_ID

Tipo: VARCHAR | Longitud: 255

Descripción: Identificación legal de la empresa.

Equivalente Formulario API: N/A

Equivalente API REST: N/A

Valores:

0+Identificación legal

(Identificación legal = RUT (Rol Unico Tributario )RFC (Registro Federal de Contribuyentes))

Ejemplo: 045251785700028

04 PAYMENT_MEANS

Tipo: VARCHAR | Longitud: 4

Descripción: Medio de pago. (Obsoleto)

Equivalente Formulario API: N/A

Equivalente API REST: N/A

Valor: Siempre será CARD.

05 CONTRACT

Tipo: VARCHAR | Longitud: 255

Descripción: Número de afiliación del vendedor.

Equivalente Formulario API: vads_contract_used

Equivalente API REST: transactionDetails.mid

Ejemplo: 0535875

06 TRANSACTION_TYPE

Tipo: VARCHAR | Longitud: 255

Descripción: Tipo de transacción.

Equivalente Formulario API: vads_operation_type

Equivalente API REST: operationType

Valores:
  • CREDIT para una transacción de reembolso
  • DEBIT para una transacción de débito
  • VERIFICATION para una transacción de verificación del medio de pago

Ejemplo: DEBIT

07 ORIGIN_AMOUNT

Tipo: NUMERIC | Longitud: 13

Descripción: Monto de la transacción en el momento del pago expresado en la unidad más pequeña de la moneda.

Equivalente Formulario API: N/A

Equivalente API REST: N/A

Ejemplo: 3000 para 30,00 USD

08 AMOUNT

Tipo: NUMERIC | Longitud: 13

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

Equivalente Formulario API: vads_amount

Equivalente API REST: amount

Ejemplo: 3000 para 30,00 USD

09 CURRENCY_CODE

Tipo: NUMERIC | Longitud: 3

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

Equivalente Formulario API: vads_currency

Equivalente API REST: currency

Ejemplo: 840 para el dólar norteamericano (USD) (Consulte la tabla vads_currency como anexo)

10 PAYMENT_DATE

Tipo: DATE | Longitud: 8

Descripción: Fecha de pago en horario UTC.

Equivalente Formulario API: vads_effective_creation_date

Equivalente API REST: creationDate

Ejemplo: 20200110

11 PAYMENT_TIME

Tipo: TIME | Longitud: 6

Descripción: Hora de pago en horario UTC.

Equivalente Formulario API: vads_effective_creation_date

Equivalente API REST: creationDate

Ejemplo: 142512

12 CARD_VALIDITY

Tipo: NUMERIC | Longitud: 6

Descripción: Periodo de validez del medio de pago.

Equivalente Formulario API: vads_expiry_year + vads_expiry_month

Equivalente API REST: transactionDetails.cardDetails.expiryYear + transactionDetails.cardDetails.expiryMonth

Ejemplo: 202306

13 CARD_TYPE

Tipo: VARCHAR | Longitud: 255

Descripción: Tipo de tarjeta.

Equivalente Formulario API: vads_card_brand

Equivalente API REST: transactionDetails.cardDetails.effectiveBrand

Ejemplo: VISA, MASTERCARD, etc.

14 CARD_NUMBER

Descripción: Las seis primeras cifras del medio de pago.

Equivalente Formulario API: vads_card_number

Equivalente API REST: transactionDetails.cardDetails.pan

Ejemplo: 497014

15 RESPONSE_CODE

Tipo: NUMERIC | Longitud: 2

Descripción: Código de retorno de la operación solicitada.

Equivalente Formulario API: vads_result

Equivalente API REST: N/A

Valores:
  • 00: Autorización aceptada.
  • 05: Autorización denegada.
  • 34: Sospecha de fraude.
  • 75: Número de intentos de ingreso del número de tarjeta superado.
  • 96: Servicio no disponible temporalmente.

Ejemplo: 00

16 COMPLEMENTARY_CODE

Tipo: NUMERIC | Longitud: 2

Descripción: Resultado de la gestión de riesgos (específica de las tiendas que hayan contratado este módulo). Campo vacío si no se realizó ningún control.

Equivalente Formulario API: vads_extra_result

Equivalente API REST: N/A

Valores:
  • 00: Controles efectuados correctamente.
  • 02: La tarjeta ha superado el monto autorizado.
  • 03: La tarjeta pertenece a la lista gris del vendedor.
  • 04: El país de emisión de la tarjeta pertenece a la lista gris o bien no pertenece a la lista blanca del vendedor.
  • 05: La dirección IP utilizada pertenece a la lista gris del vendedor.
  • 06: La tarjeta pertenece a la lista gris BIN del vendedor.
  • 07: Control de la tarjeta de débito electrónica.
  • 08: Transacción no garantizada 3DS.
  • 14: Control de la tarjeta con autorización sistemática.
  • 20: Control de coherencia país, entre el país emisor de la tarjeta, la dirección IP y el país de la dirección del cliente.
  • 99: Problema técnico encontrado por el servidor al procesar uno de los controles locales.

Ejemplo: 00

17 CERTIFICATE

Tipo: VARCHAR | Longitud: 255

Descripción: Certificado de la transacción.

Equivalente Formulario API: vads_payment_certificate

Equivalente API REST: N/A

Ejemplo: 6ed7b71c023a20adbadf9a2e2c58cd4321f63123

18 AUTORISATION_ID

Tipo: VARCHAR | Longitud: 6

Descripción: Número de autorización de la transacción.

Equivalente Formulario API: vads_auth_number

Equivalente API REST: transactionDetails.cardDetails.authorizationResponse.authorizationNumber

Ejemplo: 3fc116

19 CAPTURE_DATE

Tipo: DATE | Longitud: 8

Descripción: Fecha de envío en banco solicitado.

Equivalente Formulario API: vads_presentation_date

Equivalente API REST: transactionDetails.cardDetails.expectedCaptureDate

Ejemplo: 20200107

20 TRANSACTION_STATUS

Tipo: VARCHAR | Longitud: 255

Descripción: Estado de la transacción.

Equivalente Formulario API: vads_trans_status

Equivalente API REST: detailedStatus

Valores: Consulte capítulo vads_trans_status

Ejemplo: CAPTURED

21 RETURN_CONTEXT

Tipo: VARCHAR | Longitud: 500

Descripción: Contexto del pedido de un comprador.

Concatenación de los valores de los campos vads_order_info, vads_order_info2, vads_order_info3 del formulario de pago, separados por el carácter |". Por encima de los 500 caracteres, la cadena se trunca. Campo vacío si no se transmite ningún campo vads_order_info.

Equivalente Formulario API: vads_order_info | vads_order_info2 | vads_order_info3

Equivalente API REST: N/A

Ejemplo:
  • info1|info2|info3 si se transmiten los 3 campos,
  • info1||info3: si solo se transmiten vads_order_info 1 y 3.
22 AUTORESPONSE_STATUS

Tipo: VARCHAR | Longitud: 255

Descripción: Estado del envío de la notificación de fin de pago (IPN).

Equivalente Formulario API: N/A

Equivalente API REST: N/A

Valores:
  • FAILED: Falla al notificar al servidor del vendedor.
  • SENT: Notificación enviada al servidor del vendedor.
  • UNDEFINED: Un evento activó la regla de notificación de fin de pago, pero la URL no está configurada.
Ejemplo: SENT
23 ORDER_ID

Tipo: VARCHAR | Longitud: 255

Descripción: Número de pedido generado por el sitio del comerciante.

Equivalente Formulario API: vads_order_id

Equivalente API REST: orderDetails.orderId

Ejemplo: CX-1254

24 CUSTOMER_ID

Tipo: VARCHAR | Longitud: 255

Descripción: Referencia del cliente generada por el sitio del comerciante.

Equivalente Formulario API: vads_cust_id

Equivalente API REST: customer.reference

Ejemplo: C2383333540

25 CUSTOMER_IP_ADDRESS

Tipo: VARCHAR | Longitud: 255

Descripción: Dirección IP del comprador.

Equivalente Formulario API: N/A

Equivalente API REST: customer.extraDetails.ipAddress

Ejemplo: 185.244.73.2

26 ACCOUNT_SERIAL

Descripción: Token seguido del n° eventual de recurrencia, separados por un guión "-".

Equivalente Formulario API: vads_identifier "-" vads_subscription

Equivalente API REST: paymentMethodToken "-" subscriptionId

Ejemplo: 5fa8d3dede8f4c219c4652dfabe2bf55-20191106ANav0o

27 TRANSACTION_CONDITION

Tipo: VARCHAR | Longitud: 255

Descripción: Resultado de la autenticación 3D Secure.

Equivalente Formulario API: N/A

Equivalente API REST: transactionDetails.cardDetails.threeDSResponse.authenticationResultData.transactionCondition

Valores:
  • 3D_SUCCESS: Vendedor y transportista inscritos en 3D Secure y tarjeta autenticada correctamente.
  • 3D_FAILURE: Vendedor y comprador inscritos en 3D Secure, pero la autenticación falló.
  • 3D_ERROR: Vendedor inscrito en 3D Secure, pero ocurrió un problema técnico.
  • 3D_NOTENROLLED: Vendedor inscrito en 3D Secure, pero el transportista no está enrolado.
  • 3D_ATTEMPT: Vendedor y transportista inscritos en 3D Secure, pero el transportista no está autenticado.
  • SSL: Transportista no autenticado:
    • o 3D Secure no admite el tipo de tarjeta,
    • o el vendedor o el transportista no están inscritos en 3D Secure

Ejemplo: 3D_SUCCESS

28 CAVV_UCAF

Tipo: VARCHAR | Longitud: 255

Descripción: Certificado 3D Secure de la transacción.

Equivalente Formulario API: vads_threeds_cavv

Equivalente API REST: transactionDetails.cardDetails.threeDSResponse.authenticationResultData.cavv

Ejemplo: Q2F2dkNhdnZDYXZ2Q2F2dkNhdnY=

29 COMPLEMENTARY_INFO

Tipo: VARCHAR | Longitud: 255

Descripción: Detalle del resultado de los controles de riesgo efectuados.

Opción reservada a los vendedores que hayan contratado el módulo de apoyo a las decisiones.

Equivalente Formulario API: vads_risk_control

Equivalente API REST: transactionDetails.fraudManagement.riskControl

Valores:
  • CARD_COUNTRY=XXX: XXX corresponde al código de país ISO 3166 alfa-3 3166.
  • MAESTRO=YES|NO: indica si el medio de pago utilizado es una tarjeta Maestro.
  • CAS=YES|NO: indica si el medio de pago utilizado es una tarjeta con autorización sistemática.
  • ECBL=YES|NO: indica si el medio de pago utilizado es una tarjeta de débito electrónica.
  • CCC=YES|NO: indica si se ha detectado una incoherencia entre el país del comprador, el medio de pago y la IP del comprador.
  • BDOM: Nombre del banco emisor del medio de pago.
  • PRODUCTCODE: Producto de la tarjeta.
  • BANKCODE: Código bancario.

Ejemplo: MAESTRO=NO|ECBL=NO|PRODUCTCODE=MDS

30 BANK_RESPONSE_CODE

Tipo: NUMERIC | Longitud: 2

Descripción: Código de respuesta a la solicitud de autorización enviada por el banco emisor.

Equivalente Formulario API: vads_auth_result

Equivalente API REST: transactionDetails.cardDetails.authorizationResponse.authorizationResult

Valores: Consulte el capítulo vads_auth_result.

Ejemplo: 00

31 3D_LS

Tipo: VARCHAR | Longitud: 255

Descripción: Garantía de pago 3DSecure.

Equivalente Formulario API: vads_warranty_result

Equivalente API REST: transactionDetails.liabilityShift

Valores:
  • YES: Pago garantizado 3D Secure
  • NO: Pago no garantizado 3D Secure
  • UNKNOWN: No puede determinarse la garantía de pago debido a un error técnico.

Ejemplo: YES

32 INFO_EXTRA

Tipo: VARCHAR | Longitud: 255

Descripción: Tiene el valor de los campos personalizables para agregar datos adicionales en el e-mail de confirmación enviado al vendedor y en la URL de notificación (vads_ext_info_).

Equivalente Formulario API: vads_ext_info

Equivalente API REST: N/A

Ejemplo:

Si vads_ext_info_key1=value1 y vads_ext_info_key2=value2,INFO_EXTRA se componen de la siguiente manera:

key1=value1|key2 = value2

Ejemplo de archivo

Descargar el pack de ejemplos: https://payzen.io/files/samples/lat/sample-files.zip.

Encontrará un archivo de ejemplo en la carpeta JT.