• Francia
Back Office Vendedor
asistencia
FAQcontacte el soporte tecnico
Buscar
Categoria
Tags
Perú
Perú
Página principal
Casos de uso
Crear un pago
Crear un pago en cuotas
Crear un pago por token
Crear un enlace de pago
Crear una suscripción
Gestione sus suscripciones
Gestione sus transacciones
Analizar los diarios
Docs API
Formulario incrustado
API REST
API REST PCI-DSS
Formulario en redirección
Pago móvil
Intercambio de ficheros
Ejemplo de código
Módulos de pago
Guías
Back Office Vendedor
Guías funcionales

Formato

El registro« TITRE »

Pos. Descripción Valores
01 Código de registro TITRE
02 Texto de la tienda como se define en el Back Office Vendedor. Ejemplo: DEMO Store
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

El registro « ENTETE » y « DETAILS »

Por defecto, el diario de las transacciones contiene los siguientes datos:

Pos. Descripción
01 ENTETE

Tipo: VARCHAR | Longitud: 11

Descripción: Código de registro.

Valor: Siempre valorizado a TRANSACTION

02 TRANSACTION_ID

Tipo: VARCHAR | Longitud: 6

Descripción: Identificador de la transacción.

Equivalente API Formulario: 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 API Formulario: N/A

Equivalente API REST: N/A

Valores:

0+ Identificación legal

(Identificación legal = RUC (Registro Único de Contribuyentes))

Ejemplo: 045251785700028

04 PAYMENT_MEANS

Tipo: VARCHAR | Longitud: 4

Descripción: Medio de pago.

Equivalente API Formulario: N/A

Equivalente API REST: N/A

Valor: Siempre valorizado a CARD.

05 CONTRACT

Tipo: VARCHAR | Longitud: 255

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

Equivalente API Formulario: vads_contract_used

Equivalente API REST: transactionDetails.mid

Ejemplo: 0535875

06 TRANSACTION_TYPE

Tipo: VARCHAR | Longitud: 255

Descripción: Tipo de transacción.

Equivalente API Formulario: 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 API Formulario: N/A

Equivalente API REST: N/A

Ejemplo: 4525 para 45,25 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 API Formulario: vads_amount

Equivalente API REST: amount

Ejemplo: 4525 para 45,25 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 API Formulario: vads_currency

Equivalente API REST: currency

Valores: Lista de monedas aceptadas

Ejemplo: 840 para el dólar norteamericano (USD)

10 PAYMENT_DATE

Tipo: DATE | Longitud: 8

Descripción: Fecha de pago en horario UTC.

Equivalente API Formulario: 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 API Formulario: 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 API Formulario: 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 API Formulario: vads_card_brand

Equivalente API REST: transactionDetails.cardDetails.effectiveBrand

Ejemplo: VISA, MASTERCARD, etc.

14 CARD_NUMBER

Descripción: Número del medio de pago en la forma 123456XXXXXX1234.

Equivalente API Formulario: vads_card_number

Equivalente API REST: transactionDetails.cardDetails.pan

Ejemplo: 123456XXXXXX1234

15 RESPONSE_CODE

Tipo: NUMERIC | Longitud: 2

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

Para más información, consulte el parámetro BANK_RESPONSE_CODE.

Valores:
  • 00 : Operación aceptada.
  • 05 : Operación rechazada.
  • 34 : Operación rechazada por sospecha de fraude.
  • 75 : Operación rechazada por sobrepasar la cantidad de intentos al ingresar del número de tarjeta.
  • 96 : Operación rechazada debido a un error técnico.

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 API Formulario: vads_extra_result

Equivalente API REST: N/A

Valores:
  • 00 : Controles efectuados correctamente.
  • 02 : La tarjeta ha superado el monto autorizado.
  • 03 : La tarjeta se encuentra en 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 garantía3DS.
  • 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 : Ha surgido un problema técnico en 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 API Formulario: vads_payment_certificate

Equivalente API REST: N/A

Ejemplo: 6ed7b71c023a20adbadf9a2e2c58cd4321f63123

18 AUTORISATION_ID

Tipo: VARCHAR | Longitud: 20

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

Equivalente API Formulario: 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 API Formulario: 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 API Formulario: vads_trans_status

Equivalente API REST: detailedStatus

Valores:

  • ACCEPTED : Transacción de verificación aceptada.
  • AUTHORISED : Transacción en espera de captura
  • AUTHORISED_TO_VALIDATE : Transacción para validar
  • CANCELLED : Transacción anulada
  • CAPTURED : Transacción capturada
  • CAPTURED_FAILED : La captura de la transacción falló
  • EXPIRED : Transacción expirada
  • PRE_AUTHORISED : Transacción pre-autorizada
  • REFUSED : Transacción rechazada
  • UNDER_VERIFICATION : Verificación en curso
  • WAITING_AUTHORISATION : Transacción en espera de solicitud de autorización o de pre-notificación
  • WAITING_AUTHORISATION_TO_VALIDATE : Transacción para validar y autorizar
  • WAITING_FOR_PAYMENT : En espera de pago
21 RETURN_CONTEXT

Tipo: VARCHAR | Longitud: 500

Descripción: Contexto del pedido de un comprador.

Concatenación de los elementos de "información adicional", separados por el carácter "|".

El sitio web comercial puede transmitir información adicional:

  • via el campo vads_order_info, vads_order_info2, vads_order_info3 del formulario de pago,
  • a través de los atributos orderInfo, orderInfo2, orderInfo3 del objeto objeto metadata de la API REST.

Por encima de los 500 caracteres, la cadena se trunca.

Campo vacío si no se transmite información adicional.

Equivalente API Formulario:vads_order_info | vads_order_info2 | vads_order_info3

Equivalente API REST: orderInfo | orderInfo2 | orderInfo3

Ejemplo:
  • info1|info2|info3 si se transmiten los 3 elementos de información adicional,
  • info1||info3: si se transmiten únicamente los elementos de información adicional 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 API Formulario: 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 a activado 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 web comercial.

Equivalente API Formulario: 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 web comercial.

Equivalente API Formulario: 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 API Formulario: N/A

Equivalente API REST: customer.extraDetails.ipAddress

Ejemplo: 185.244.73.2

26 ACCOUNT_SERIAL

Descripción: Token seguido del número de suscripción, separados por un guión "-".

Equivalente API Formulario: 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ón3D Secure.

Equivalente API Formulario: N/A

Equivalente API REST: N/A

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 : Comerciante inscrito en 3D Secure, pero ocurrió un problema técnico.
  • 3D_NOTENROLLED : Comerciante inscrito en3D Secure, pero el transportista no está registrado
  • 3D_ATTEMPT : Vendedor y transportista inscritos en3D Secure, pero el transportista no está autenticado.
  • SSL: Transportista no autenticado:
    • tipo de tarjeta no aceptado por 3D Secure,
    • o el vendedor o el transportista no están inscritos en3D Secure

Ejemplo:3D_SUCCESS

28 CAVV_UCAF

Tipo: VARCHAR | Longitud: 255

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

Equivalente API Formulario: vads_threeds_cavv

Equivalente API REST: transactionDetails.cardDetails.authenticationResponse.value.authenticationValue.value

Ejemplo: Q**************************=

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 API Formulario: 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. Valores:vads_bank_product.
  • BANKCODE : Código bancario.

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

30 BANK_RESPONSE_CODE

Tipo: VARCHAR | Longitud: 255

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

Equivalente API Formulario: vads_auth_result

Equivalente API REST: transactionDetails.cardDetails.authorizationResponse.authorizationResult

Valores: Lista de códigos de retorno de la solicitud de autorización

Ejemplo: 00

31 3D_LS

Tipo: VARCHAR | Longitud: 255

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

Equivalente API Formulario: vads_warranty_result

Equivalente API REST: transactionDetails.liabilityShift

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

Ejemplo: YES

32 INFO_EXTRA

Tipo: VARCHAR | Longitud: 4096

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 API Formulario: vads_ext_info

Equivalente API REST: metadata

Ejemplo:

Si vads_ext_info_key1=value1 y vads_ext_info_key2=value2, INFO_EXTRAse componen de la siguiente manera

key1=value1 | key2 = value2

Ejemplo de archivo

Descargar el pack de ejemplos: https://secure.micuentaweb.pe/doc/files/samples/sample-files.zip.

Un archivo de ejemplo se encuentra disponible en la carpeta Reporting/JT.

© 2025 Todos los derechos reservados de Izipay
25.17-1.11