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.
    Tabla 1. Valores asociados al campo vads_trans_status
    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ó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á capturada automáticamente en la fecha prevista.

    Este estado es enviado en los siguientes casos:
    • vads_url_check_src="PAY"

      La transacción acaba de ser realizada.La transacción fue creada en modo “captura diferida”.

    • vads_url_check_src="BO"

      El vendedor envió la notificación de una transacción no capturada desde su Back Office Vendedor.

    • vads_url_check_src="BATCH"

      El estado de la transacción acaba de ser actualizado.

    AUTHORISED_TO_VALIDATE

    Por validar

    La transacción, creada en validación manual, está autorizada. El vendedor debe validar manualmente la transacción para que sea capturada 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 vencida. Si esta fecha se supera, el pago toma el estado EXPIRED. El estado Expirado es definitivo.

    Este estado es enviado en el siguiente caso:
    • El vendedor creó la transacción en modo “validación manual”.
    • La transacción fue creada en modo “captura diferida”.
    CANCELLED

    Anulado

    La transacción es anulada por el vendedor.

    CAPTURED

    Capturada

    La transacción es capturada al banco.

    Este estado es enviado en los siguientes casos:
    • vads_url_check_src="PAY"

      La transacción acaba de ser realizada.Fue creada en modo “captura inmediata”

    • vads_url_check_src="BO"

      El vendedor envió la notificación de una transacción capturada desde su Back Office Vendedor

    • vads_url_check_src="BATCH"

      El estado de la transacción acaba de ser actualizado.

    CAPTURE_FAILED

    La captura de la transacción falló.

    Contacte al Soporte.

    EXPIRED

    Expirado

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

    Este estado es enviado en el siguiente caso:
    • el vendedor creó la transacción en modo “validación manual”
    • La transacción fue creada en modo “captura diferida”
    • El vendedor activó la regla de notificación en modificación por lote
    INITIAL En espera

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

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

      o

    • el plazo de respuesta de parte del adquirente 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

    Se rechaza la transacción.

    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 captura al banco es superior a la duración de validez de la autorización.

    WAITING_AUTHORISATION_TO_VALIDATE

    Para validar y autorizar

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

    Se aceptó una autorización 1 USD.

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

    WAITING_FOR_PAYMENT Utilizado para los pagos mediante Boleto con el adquiriente Bradesco. Al final del pago, el Boleto se envía al comprador por e-mail en formato PDF. La transacción aún no se ha pagado. Su estado se mantendrá en WAITING_FOR_PAYMENT hasta que sea pagada. Su estado se actualizará automáticamente a REFUSED o CAPTURED.
  4. Tome la referencia del pago indicada en el campo vads_trans_id.
  5. 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.

  6. Tome el valor del campo vads_trans_date para identificar la fecha de pago.
  7. Analice el campo vads_payment_option_code para determinar si se trata de un pago en varias cuotas:
    Tabla 2. 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
  8. 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.
  9. Tome el monto y la moneda utilizada. Para esto, tome los valores de los siguientes campos:
    Tabla 3. 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.
  10. 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.
  11. 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 afiliación de la tarjeta.
      Tabla 4. Valores del campovads_threeds_enrolled
      Valor Descripción
      Vacío Proceso 3DS no realizado (3DS desactivado en la solicitud, comerciante no afiliado al medio de pago no elegible para 3DS).
      Y Autenticación disponible, titular inscrito.
      N Titular no inscrito.
      U Imposible identificar al titular 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 5. Valores del campo vads_threeds_status
      Valor Descripción
      Vacío Autenticación 3DS no realizada (3DS desactivado en la solicitud, comerciante no afiliado al medio de pago no elegible para 3DS).
      Y Portador autenticado correctamente.
      N Error de autenticación del titular.
      U Autenticación imposible.
      A Tentativa de autenticación, pero no se realizó la autenticación.
  12. Tome el tipo de tarjeta utilizada para el pago.
    Tabla 6. 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.: VISA, VISA_ELECTRON, MASTERCARD, MAESTRO, VPAY
    vads_card_number Número de la tarjeta utilizada para realizar el pago.

    vads_expiry_month Mes de caducidad entre 1 y 12 (p. ej.: 3 para marzo, 10 para octubre).
    vads_expiry_year Año de caducidad 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.:"BR" para Brasil, "AR" para Argentina, "PE" para Perú, "US" para Estados Unidos.).
  13. Registre el valor del campo vads_trans_uuid. Este le permitirá identificar de manera única la transacción si utiliza la API Web Services.
  14. 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.
  15. Proceda a actualizar la orden.