Procesamiento de los datos de la respuesta
A continuación se muestra un ejemplo para guiarle paso a paso durante el tratamiento de los datos de la respuesta.
- Identifique el modo (TEST o PRODUCTION) en el que fue creada la transacción analizando el valor del campo vads_ctx_mode.
- Identifique el pedido recuperando el valor del campo vads_order_id si lo transmitió en el
formulario de pago. Verifique que el estado del pedido no ha sido actualizado.
- Recupere el resultado del pago indicado en el campo vads_trans_status. Su valor le permite definir el estado del pedido.
Valor Descripción ABANDONED Abandonado El comprador ha abandonado el pago.
La transacción no se creó y por lo tanto no está visible en el Back Office Vendedor.
ACCEPTED Aceptado. Estado de una transacciónVERIFICATIONcuya autorización ha sido aceptada.
Este estado no puede cambiar.
Las transacciones con estado Aceptado no se capturan nunca.
AUTHORISED En espera de captura
La transacción ha sido aceptada y será capturada automáticamente en la fecha prevista.
AUTHORISED_TO_VALIDATE Por validar
La transacción, creada en validación manual, ha sido autorizada. El vendedor debe validar manualmente la transacción para que se capture.
Se puede validar la transacción si no se ha sobrepasado la fecha de expiración de la petición de autorización. Si esta fecha se ha superado, el pago tiene el estado Expirado. Este estado es definitivo.
CANCELLED Anulado
El vendedor ha anulado la transacción.
CAPTURED Presentado
La transacción ha sido capturada.
CAPTURE_FAILED La captura de la transacción falló.
Contacte a la asistencia técnica.
EXPIRED Expirado
Este estado se muestra en el ciclo de vida de un pago con captura diferida.
Se alcanzó la fecha de expiración de la petición de autorización, pero el vendedor no validó la transacción. No se debita al titular.
REFUSED Rechazado
La transacción ha sido rechazada.
SUSPENDED Suspendido El adquirente AMEX GLOBAL o SECURE TRADING ha bloqueado temporalmente la captura de la transacción. Una vez que la captura ha sido procesada correctamente, el estado de la transacción pasa aCAPTURED.
UNDER_VERIFICATION Verificación en curso
En espera de la respuesta del adquiriente.
Este estado es temporal.
Cuando el estado cambia, se notifica al vendedor.
Requiere la activación de la regla de notificación URL de notificación al modificar por batch.
WAITING_AUTHORISATION En espera de autorización El plazo de captura es superior al periodo de validez de la autorización.
WAITING_AUTHORISATION_TO_VALIDATE Por validar y autorizar
El plazo de captura es superior al periodo 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 petición de autorización y la captura.
WAITING_FOR_PAYMENT En espera de pago
Estado temporal. El estado de la transacción permanece enWAITING_FOR_PAYMENThasta que se pague.
El estado se actualiza automáticamente aREFUSEDoCAPTURED.
Afecta a todos los medios de pagos realizados en efectivo o .
- Analice el campo vads_occurrence_type para determinar si se trata de un pago unitario o
de un pago que forma parte de una serie (suscripción).
Valor Descripción UNITAIRE Pago unitario (pago al contado). RECURRENT_INITIAL Primer pago de una serie. RECURRENT_INTERMEDIAIRE Enésimo pago de una serie. RECURRENT_FINAL Último pago de una serie. - Recupere el valor del campo vads_trans_date para identificar la fecha de pago.
- Analice el campo vads_payment_option_code para determinar si se trata de un pago en
varias cuotas:
Valor Descripción 1 Pago en 1 cuota 2 Pago en 2 cuotas 3 Pago en 3 cuotas n Pago en cuotas - Recupere el valor del campo vads_capture_delay para determinar la cantidad de días antes de la
captura. Esto le permitirá determinar si se trata de un pago inmediato o diferido.
- Recupere el monto y la divisa utilizada. Para ello, recupere los valores de los siguientes campos:
Nombre del campo Descripción vads_amount Monto del pago en su fracción monetaria más pequeña. vads_currency Código de la divisa utilizada para el pago. - Recupere el valor del campo vads_auth_result para conocer el resultado de la petición
de autorización. La lista completa de los códigos devueltos se puede consultar en el diccionario de datos.
- Recupere el resultado de la autentificación del titular. Para ello:
- Recupere el valor del campo vads_threeds_enrolled para determinar el estado de inscripción
de la tarjeta.
Valor Descripción Vacío Proceso 3DS no realizado (3DS desactivado en la petición, vendedor no inscrito o medio de pago no elegible para 3DS). Y Autentificación disponible, titular inscrito. N Titular no inscrito. U Imposible identificar al titular de la tarjeta o tarjeta no elegible para los intentos de autentificación (ejemplo: tarjetas comerciales o prepagadas). - Consulte el resultado de la autentificación del titular tomando el valor del campovads_threeds_status.
Valor Descripción Vacío Autentificación 3DS no realizada (3DS desactivado en la solicitud, titular no afiliado al medio de pago no elegible para 3DS). Y Titular autentificado correctamente. N Error de autentificación del portador. U Autentificación imposible. A Intento de autentificación ha sido infructuoso.
- Recupere el valor del campo vads_threeds_enrolled para determinar el estado de inscripción
de la tarjeta.
- Recupere el resultado de los controles de fraude identificando el valor del campovads_risk_control. Este campo se envía únicamente si el vendedor:
- contrató el servicio "Ayuda con la decisión"
- activó al menos un control desde su Back Office Vendedor (menú Configuración > Control de riesgos).
El campo toma como valor una lista de valores separados por comas (,), cuya sintaxis es: vads_risk_control = control1=result1;control2=result2Los valores posibles para control son:Valor Descripción CARD_FRAUD Verifica la presencia del número de la tarjeta del comprador en la lista gris de tarjetas. SUSPECT_COUNTRY Verifica la presencia del país emisor de la tarjeta del comprador en la lista de países prohibidos. IP_FRAUD Verifica la presencia de la dirección IP del comprador en la lista gris de IP. CREDIT_LIMIT Verifica la frecuencia y los montos de compra de un mismo número de tarjeta o bien el monto máximo de un pedido. BIN_FRAUD Verifica la presencia del código BIN de la tarjeta en la lista gris de códigos BIN. COMMERCIAL_CARD Verifica si la tarjeta del comprador es una tarjeta empresarial. INCONSISTENT_COUNTRIES Verifica 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. SUSPECT_IP_COUNTRY Verifica la presencia del país del comprador (mediante su dirección IP) en la lista de países prohibidos. Los valores posibles para result son:Valor Descripción OK OK. WARNING Control informativo fallido. ERROR Control de bloqueo fallido. - Recupere el tipo de tarjeta utilizada para el pago.
Nombre del campo Descripción vads_card_brand Marca de la tarjeta utilizada para el pago. Ejemplo: VISA, VISA_ELECTRON, MASTERCARD, MAESTRO, VPAY vads_card_number Número de la tarjeta utilizada para realizar el pago. vads_expiry_month Mes de expiración entre 1 y 12 (ejemplo: 3 por marzo, 10 por octubre). vads_expiry_year Año de expiración de 4 cifras (ejemplo: 2023). vads_bank_code Código del banco emisor vads_bank_label Nombre 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, por ejemplo: "BR"por Brasil"AR"para Argentina,"PE"por Colombia "US"por Estados Unidos). - Guarde el valor del campo vads_trans_uuid. Este le permitirá identificar de manera única la transacción si utiliza las API servicios Web.
- Recupere la información del pedido, del comprador y de la entrega. Estos datos están presentes en la respuesta solamente si fueron enviados en el formulario de pago.Su valor es idéntico al valor ingresado en el formulario.
- Actualice el pedido.