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.
- 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 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.
- 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ó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 es aceptada y será remitida al banco automáticamente en la fecha prevista.
CANCELLED Anulado
La transacción es anulada por el vendedor.
CAPTURED Capturada
La transacción se ha remitido al banco.
CAPTURE_FAILED La remesa de la transacción ha fallado.
Contacte al Soporte.
EXPIRED Vencido
Este estado interviene en el ciclo de vida de un pago con captura diferida.
En el caso de un pago con EFECTY, si el comprador no ha finalizado su compra dentro de los plazos establecidos, el estado de la transacción toma el valor "EXPIRED".
REFUSED Rechazado
La transacción se ha rechazado.
UNDER_VERIFICATION Comprobación en curso
En espera de la respuesta del adquirente.
Este estado es temporal.
Se enviará una notificación al sitio del comerciante para advertirle sobre el cambio de estado.
Requiere la activación de la regla de notificación URL de notificación al modificar por batch.
WAITING_FOR_PAYMENT En espera de pago
Estado temporal. El estado de la transacción permanece en WAITING_FOR_PAYMENT hasta el pago.
Su estado se actualizará automáticamente a REFUSED o CAPTURED.
Corresponde a todos los medios de pagos realizados en efectivo .
- 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. - Tome 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 n cuotas - 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.
- Tome el monto y la moneda utilizada. Para esto, tome los valores de los siguientes campos:
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. - 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.
- Tome el resultado de la autenticación del titular. Para esto:
- Tome el valor del campo vads_threeds_enrolled para determinar el estado de la inscripción de la tarjeta.
Valor Descripción Vacío Proceso 3DS no realizado (3DS desactivado en la solicitud, vendedor no inscrito o medio de pago no elegible para 3DS). Y Autenticación disponible, portador inscrito. N Titular no enrolado. U Imposible identificar al portador o tarjeta no elegible para las tentativas de autenticación (p. ej., tarjetas comerciales o prepagadas). - Tome el resultado de la autenticación del titular recuperando el valor del campo vads_threeds_status.
Valor Descripción Vacío Autenticación 3DS no realizada (3DS desactivado en la solicitud, vendedor 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.
- Tome el valor del campo vads_threeds_enrolled para determinar el estado de la inscripción de la tarjeta.
- 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 vendedor:
- 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=result2Los valores posibles para control son:Valor Descripción CARD_FRAUD Control de la presencia del número de la tarjeta del comprador en la lista negra 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 Controlar la presencia de la dirección IP del comprador en la lista negra de IP. CREDIT_LIMIT Control de la frecuencia y el monto de compras de un mismo número de tarjeta, o del monto máximo de un pedido. BIN_FRAUD Controla la presencia del código BIN de la tarjeta dentro de la lista gris de códigos BIN. COMMERCIAL_CARD Controla si la tarjeta del comprador es una tarjeta comercial. 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. 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:Valor Descripción OK OK. WARNING Control informativo no exitoso. ERROR Control de bloqueo no exitoso. - Tome el tipo de 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 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_label Apellido 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.). - Registre el valor del campo vads_trans_uuid. Este le permitirá identificar de manera única la transacción si utiliza la API Web Services.
- 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.
- Proceda a actualizar el pedido.