Tratamiento de los datos de la respuesta

A continuación hay un ejemplo de análisis para guiarle paso a paso durante el tratamiento de los datos de la respuesta.

  1. Identifique el modo (TEST o PRODUCTION) en el que fue creada la transacción analizando el valor del campo vads_ctx_mode.
  2. Identifique el pedido tomando el valor del campo vads_order_id si lo indicó en el formulario de pago.
    Verifique que el estado de la orden no haya sido actualizado.
  3. Tome el resultado del pago indicado en el campo vads_trans_status.
    Su valor le permite definir el estado de la orden.
    Valor Descripción
    ABANDONED Abandonado

    Pago abandonado por el comprador.

    La transacción no se creó y por lo tanto no es visible en el Back Office Vendedor.

    ACCEPTED Aceptado

    Estado de una transacción de tipo VERIFICATION cuya autorizacióno solicitud de información ha sido aceptada.

    Este estado no puede cambiar.

    Las transacciones con estado "ACCEPTED" no se capturan nunca.

    AUTHORISED

    En espera de captura

    La transacción fue aceptada y será entregada al banco automáticamente en la fecha prevista.

    AUTHORISED_TO_VALIDATE

    Por validar

    La transacción, creada en validación manual, está autorizada. El comerciante debe validar manualmente la transacción para que sea entregada al banco.

    La transacción puede ser validada siempre y cuando la fecha de expiración de la solicitud de autorización no se haya superado. Si esta fecha se supera, el pago toma el estado EXPIRED. El estado Expirado es definitivo.

    CANCELLED

    Anulado

    La transacción es anulada por el comerciante.

    CAPTURED

    Capturada

    La transacción es entregada al banco.

    CAPTURE_FAILED

    La recepción de la transacción falló.

    Contacte al Soporte.

    EXPIRED

    Expirado

    La fecha de expiración de la solicitud de autorización se alcanzó y el comerciante no validó la transacción. No se realizará el débito al portador.

    INITIAL En espera

    Este estado es específico para todos los medios de pago que requieren una integración mediante formulario de pago en la redirección.

    Este estado es recibido cuando:
    • el comprador no envió ninguna repuesta

      o

    • el plazo de respuesta de parte del comprador es superior a la duración de sesión del pago en la plataforma de pago.

      Este estado es temporal. El estado definitivo será mostrado en el Back Office Vendedor tan pronto se realiza la sincronización.

    NOT_CREATED

    Transacción no creada

    La transacción no se creó y por lo tanto no es visible en el Back Office Vendedor.

    REFUSED

    Rechazado

    La transacción fue rechazada.

    SUSPENDED Suspendido

    La captura de la transacción está bloqueada temporalmente por el adquirente (AMEX GLOBAL o SECURE TRADING). Una vez que la captura se procesa correctamente, el estado de la transacción se CAPTURED.

    UNDER_VERIFICATION

    Para las transacciones PayPal, este valor significa que PayPal retiene la transacción por sospecha de fraude.

    El pago permanecerá en la pestaña Transacciones en curso hasta que se completen las verificaciones. La transacción tomará uno de los siguientes estados: AUTHORISED o CANCELED.

    Se enviará una notificación al vendedor para advertirle del cambio de estado (Notificación sobre la modificación de lotes).

    WAITING_AUTHORISATION En espera de autorización

    El plazo de entrega al banco es superior a la duración de validez de la autorización.

    WAITING_AUTHORISATION_TO_VALIDATE

    Por validar y autorizar

    El plazo de entrega al banco es superior a la duración de validez de la autorización.

    Se aceptó una autorización 1 EUR (o solicitud de información en la red de CB si el adquirente lo admite).

    El comerciante debe validar manualmente la transacción para que se realice la orden de autorización y la entrega.

  4. Tome la referencia del pago indicada en el campo vads_trans_id.
  5. Analice el campo vads_payment_config para determinar si se trata de un pago al contado (unitario) o de un pago en varias veces.
    Tabla 1. Análisis del campo vads_payment_config
    Nombre del campo Valor para un pago al contado Valor para un pago en varias veces
    vads_payment_config SINGLE MULTI

    (donde la sintaxis exacta es MULTI:first=X;count=Y;period=Z)

    Si se trata de un pago en varias veces, identifique el número del vencimiento tomando el valor del campo vads_sequence_number.
    Tabla 2. Análisis del campo vads_sequence_number
    Valor Descripción
    1 Primer vencimiento
    2 Segundo vencimiento
    3 Tercer vencimiento
    n N vencimiento
  6. Analice el campo vads_sequence_number para el número de intentos realizados para realizar el pago.
    vads_payment_config = SINGLE :
    vads_url_check_src vads_sequence_number Descripción
    PAY 1 Pago realizado en 1 intento.
    2 Pago realizado en 2 intentos.
    3 Pago realizado en 3 intentos.
    BATCH_AUTO 1 Pago diferido realizado en 1 intento.
    2 Pago diferido realizado en 2 intentos.
    3 Pago diferido realizado en 3 intentos.

    Nota

    El pago en cuotas no es compatible con la función de intentos adicionales en caso de pago denegado.

  7. Tome el valor del campo vads_trans_date para identificar la fecha de pago.
  8. Analice el campo vads_payment_option_code para determinar si se trata de un pago en varias cuotas:
    Tabla 3. Análisis del campo vads_payment_option_code
    Valor Descripción
    1 Pago en 1 cuota
    2 Pago en 2 cuotas
    3 Pago en 3 cuotas
    n Pago en n cuotas
  9. Tome el valor del campo vads_capture_delay para identificar el número de días antes de la entrega al banco.
    Esto le permitirá identificar si se trata de un pago inmediato o diferido.
  10. Tome el monto y la divisa utilizada. Para esto, tome los valores de los siguientes campos:
    Tabla 4. Análisis del monto y de la moneda utilizada
    Nombre del campo Descripción
    vads_amount Monto del pago en su unidad monetaria más pequeña.
    vads_currency Código de la moneda utilizada para el pago.
    vads_change_rate Tasa de cambio utilizada para calcular el monto real del pago (vervads_effective_amount).
    vads_effective_amount Monto del pago en la divisa realmente utilizada para efectuar la entrega al banco.
    vads_effective_currency Moneda en la que será efectuado el depósito.
  11. Tome el valor del campo vads_auth_result para conocer el resultado de la solicitud de autorización:
    La lista completa de los códigos enviados se puede consultar en el diccionario de datos.
    Para ayudarle a entender el motivo del rechazo, a continuación está una lista de los códigos frecuentemente devueltos:
    Tabla 5. Valores asociados al campo vads_auth_result
    Valor Descripción
    03

    Aceptador inválido

    Este código es emitido por el adquirente. Corresponde a un problema de configuración en los servidores de autorización. (p. ej., contrato cerrado, código MCC declarado incorrecto, etc.).

    Para conocer la razón precisa del rechazo, el comerciante debe contactar a su banco.
    05 No cumplir

    Este código es emitido por el banco emisor de la tarjeta. Es utilizado en los siguientes casos:

    • fecha de expiración no válida,
    • código de seguridad CVV no válido,
    • crédito sobrepasado,
    • saldo insuficiente (etc.)
    Para conocer la razón precisa del rechazo, el comprador debe contactar a su banco.
    51 Saldo insuficiente o crédito sobrepasado

    Este código es emitido por el banco emisor de la tarjeta. Puede ser obtenido si el comprador no cuenta con un saldo suficiente para realizar su compra.

    Para conocer la razón precisa del rechazo, el comprador debe contactar a su banco.
    56 Tarjeta ausente del archivo

    Este código es emitido por el banco emisor de la tarjeta.

    El número de la tarjeta ingresado es erróneo o el número de tarjeta y la fecha de expiración no existen.
    57 Transacción no permitida a este titular

    Este código es emitido por el banco emisor de la tarjeta. Es utilizado en los siguientes casos:

    • el comprador trata de realizar un pago por internet con una tarjeta de retiro,
    • el límite autorizado de la tarjeta se superó.
    Para conocer la razón precisa del rechazo, el comprador debe contactar a su banco.
    59 Sospecha de fraude

    Este código es emitido por el banco emisor de la tarjeta. Puede ser enviado después de ingresar varias veces el CVV o la fecha de expiración erróneos.

    Para conocer la razón precisa del rechazo, el comprador debe contactar a su banco.
    60

    El aceptador de la tarjeta debe contactar al adquirente

    Este código es emitido por el adquirente. Corresponde a un problema de configuración en los servidores de autorización. Se utiliza cuando el contrato del comerciante no corresponde al canal de venta utilizado. (p. ej., una transacción de comercio electrónico con un contrato VAD-de ingreso manual).

    Contacte al servicio al cliente para regularizar la situación.
  12. Tome el resultado de la autenticación 3D Secure. Para esto:
    1. Tome el valor del campo vads_threeds_enrolled para determinar el estado de la inscripción de la tarjeta.
      Tabla 6. Valores del campovads_threeds_enrolled
      Valor Descripción
      Vacío Proceso 3DS no realizado (3DS desactivado en la solicitud, comerciante no inscrito o medio de pago no elegible para 3DS).
      Y Autenticación disponible, portador inscrito.
      N Portador no inscrito.
      U Imposible identificar al portador o tarjeta no elegible para las tentativas de autenticación (p. ej., tarjetas comerciales o prepagadas).
    2. Tome el resultado de la autenticación 3D Secure usando el valor del campo vads_threeds_status.
      Tabla 7. Valores del campo vads_threeds_status
      Valor Descripción
      Vacío Autenticación 3DS no realizada (3DS desactivado en la solicitud, comerciante no inscrito o medio de pago no elegible para 3DS).
      Y Portador autenticado correctamente.
      N Error de autenticación del portador.
      U Autenticación imposible.
      A Tentativa de autenticación, pero no se realizó la autenticación.
  13. Tome el resultado de los controles asociados con el fraude identificando el valor del campo vads_risk_control. Este campo es enviado únicamente si el comerciante:
    • se suscribe al servicio "Ayuda con la decisión"
    • activó al menos un control desde su Back Office Vendedor (menú Configuración > Control de riesgos).
    Esto toma como valor una lista de valores separados por “;” cuya sintaxis es: vads_risk_control = control1=result1;control2=result2
    Los valores posibles para control son:
    Tabla 8. Lista de controles asociados al fraude
    Valor Descripción
    CARD_FRAUD Controla la presencia del número de la tarjeta del comprador dentro de la lista gris de tarjetas.
    SUSPECT_COUNTRY Controla la presencia del país emisor de la tarjeta del comprador dentro de la lista de países prohibidos.
    IP_FRAUD Controla la presencia de la dirección IP del comprador dentro de la lista gris de direcciones IP.
    CREDIT_LIMIT Controla la frecuencia y los montos de compra de un mismo número de tarjeta, o el monto máximo de una orden.
    BIN_FRAUD Controla la presencia del código BIN de la tarjeta dentro de la lista gris de códigos BIN.
    ECB Controla si la tarjeta del comprador es de tipo débito.
    COMMERCIAL_CARD Controla si la tarjeta del comprador es una tarjeta comercial.
    SYSTEMATIC_AUTO Controla si la tarjeta del comprador es una tarjeta con autorización sistemática.
    INCONSISTENT_COUNTRIES Controla si el país de la dirección IP, el país emisor de la tarjeta de pago y el país de la dirección del comprador son coherentes entre ellos.
    NON_WARRANTY_PAYMENT Transferencia de responsabilidad.
    SUSPECT_IP_COUNTRY Controla la presencia del país del comprador, identificado mediante su dirección IP, dentro de la lista de países prohibidos.
    Los valores posibles para result son:
    Tabla 9. Lista de controles asociados al fraude
    Valor Descripción
    OK OK.
    WARNING Control informativo no exitoso.
    ERROR Control de bloqueo no exitoso.
  14. Tome el tipo de tarjeta utilizada para el pago.
    Se pueden presentar dos casos:
    • Para un pago realizado con una sola tarjeta. Los campos correspondientes son los siguientes:
    Tabla 10. Análisis de la tarjeta utilizada para el pago
    Nombre del campo Descripción
    vads_card_brand Marque la tarjeta utilizada para el pago. P. ej.: CB, VISA, VISA_ELECTRON, MASTERCARD, MAESTRO, VPAY
    vads_brand_management

    Permite conocer la marca utilizada al pagar, la lista de marcas disponibles y si el comprador debe cambiar la marca elegida por el vendedor.

    vads_card_number Número de la tarjeta utilizada para realizar el pago.

    vads_expiry_month Mes de expiración entre 1 y 12 (p. ej.: 3 para marzo, 10 para octubre).
    vads_expiry_year Año de expiración de 4 cifras (p. ej.: 2023).
    vads_bank_code Código del banco emisor
    vads_bank_product Código de producto de la tarjeta
    vads_card_country Código de país del país de emisión de la tarjeta (Código alfa ISO 3166-2 ej.:"FR" para Francia, "PF" para la Polinesia Francesa, "NC" para la la Nueva Caledonia, "US" para Estados Unidos.).
    • Para un pago fraccionado (es decir, una transacción que utiliza varios medios de pago), los campos correspondientes son los siguientes:
      Nombre del campo Valor Descripción
      vads_card_brand MULTI Se utilizan varios tipos de tarjeta para el pago.
      vads_payment_seq En formato json, ver detalles a continuación. Detalles de las transacciones realizadas.
      El campo vads_payment_seq (formato json) describe la secuencia de pago fraccionado. Contiene los elementos:
      1. "trans_id": identificador de la transacción global en la secuencia de pago.
      2. "transaction": cuadro de las transacciones de la secuencia. Los elementos que lo componen son los siguientes:
    Tabla 11. Contenido del objeto JSON
    Nombre del parámetro Descripción
    amount

    Monto de la secuencia de pago.

    operation_type

    Operación de débito.

    auth_number

    Número de autorización. Ejemplo: 949478

    auth_result Código de retorno de la solicitud de autorización.
    capture_delay Plazo antes de la entrega (en días).
    • Para un pago con tarjeta bancaria, el valor de este parámetro tiene en cuenta el plazo en número de días antes de la entrega al banco. Si este parámetro no es transmitido en el formulario de pago, se utilizará el valor predeterminado definido en el Back Office Vendedor.
    card_brand

    Medio de pago utilizado.

    Para un pago con tarjeta bancaria (por ejemplo CB o tarjetas CB de marca compartida Visa o Mastercard), este parámetro tiene el valor "CB".

    Consultar la guía de integración del formulario de pago disponible en nuestro sitio de documentación para visualizar la lista completa de los tipos de tarjeta.

    card_number

    Número del medio de pago.

    expiry_month

    Mes de caducidad del medio de pago.

    expiry_year

    Año de expiración del medio de pago.

    payment_certificate Certificado de pago.
    contract_used Afiliación utilizada para el pago.
    identifier Identificador único (token) asociado a un medio de pago.
    identifier_status Presente solo si la acción solicitada es la creación o actualización de un token.
    Valores posibles:
    Valor Descripción
    CREATED

    La solicitud de autorización fue aceptada.

    El token (o RUM para un pago SEPA) se crea con éxito.

    NOT_CREATED

    La solicitud de autorización fue denegada.

    El token (o RUM para un pago SEPA) no se crea y no aparecerá en el Back Office Vendedor.

    UPDATED El token (o RUM para un pago SEPA) se actualiza con éxito.
    NOT_UPDATED El token (o RUM para un pago SEPA) no se ha actualizado.
    ABANDONED

    Acción abandonada por el comprador (deudor).

    El token (o RUM para un pago SEPA) no se crea y no aparecerá en el Back Office Vendedor.

    presentation_date

    Para un pago con tarjeta bancaria, este parámetro corresponde a la fecha de entrega al banco deseada (en el formato ISO 8601).

    trans_id Número de transacción.
    ext_trans_id

    Parámetro ausente para el pago con tarjeta bancaria.

    trans_uuid Referencia única generada por la plataforma de pago después de la creación de una transacción de pago.

    Ofrece una garantía de singularidad para cada transacción

    extra_result Código numérico del resultado de los controles de riesgo.
    Code Descripción
    Vacío No se hace ningún control.
    00 Todos los controles fueron exitosos.
    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 del vendedor.
    05 La dirección IP pertenece a la lista gris del vendedor.
    06 El código bin pertenece a la lista gris del vendedor.
    07 Detección de una tarjeta electrónica de crédito.
    08 Detección de una tarjeta comercial nacional.
    09 Detección de una tarjeta comercial extranjera.
    14 Detección de una tarjeta con autorización sistemática.
    20 Verificación de consistencia: no hay coincidencias de país (IP del país, mapa del país, país del comprador).
    30 El país de la dirección IP pertenece a la lista gris.
    99 Problema técnico encontrado por el servidor al procesar uno de los controles locales
    sequence_number Número de secuencia.
    trans_status Estado de la transacción.
    Nota : las transacciones anuladas también se encuentran en el cuadro.
  15. Registre el valor del campo vads_trans_uuid. Este le permitirá identificar de manera única la transacción si utiliza la API Web Services.
  16. Tome toda la información sobre el detalle del pedido, el detalle del comprador y el detalle de la entrega.
    Estos datos solo están presentes en la respuesta si se enviaron en el formulario de pago.
    Sus valores son iguales a los enviados en el formulario.
  17. Proceda a actualizar el pedido.