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.
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 Vencido es definitivo.
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.
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.
PRE_AUTHORISED Pre-autorizada
Cuando la afiliación está configurada en modo “Preautorización”, todos los pagos se realizan con una solicitud de autorización válida por treinta días. En dicho caso, hablamos de preautorización.
Durante este período, se permite al comerciante modificar el monto hacia arriba, una sola vez, hasta un máximo del 199 % del monto inicial. También puede modificar la fecha de remesa para capturar la transacción antes de la fecha de expiración de la preautorización.
Al alcanzar la fecha de remesa, el estado de la transacción pasa de PRE_AUTHORISED a CAPTURED.
Los pagos realizados en modo “Preautorización” no pueden abonarse en varias cuotas.
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_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 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.
- 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 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:
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.). - Para un pago fraccionado (es decir, una transacción que utiliza varios medios de pago), los campos correspondientes son los siguientes:El campo vads_payment_seq (formato json) describe la secuencia de pago fraccionado. Contiene los elementos:
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. - "trans_id": identificador de la transacción global en la secuencia de pago.
- "transaction": cuadro de las transacciones de la secuencia. Los elementos que lo componen son los siguientes:
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.
No se devolverá si no se aplica al medio de pago en cuestión.
Ejemplo: 949478
auth_result Código de retorno de la solicitud de autorización. capture_delay Plazo antes de la captura (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 del captura. Si este parámetro no es transmitido en el formulario de pago, se utilizará el valor predeterminado definido en Back Office Vendedor.
card_brand Medio de pago utilizado.
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 caducidad del medio de pago.
payment_certificate Certificado de pago. contract_used Afiliación utilizada para el pago. identifier Identificador único (token/alias) asociado a un medio de pago. identifier_status Presente solo si la acción solicitada es la creación o actualización de un alias. Valores posibles:Valor Descripción CREATED La solicitud de autorización fue aceptada.
El token se crea con éxito.
NOT_CREATED La solicitud de autorización fue denegada.
El token no se crea y no aparecerá en el Back Office Vendedor.
UPDATED El token se actualiza con éxito. NOT_UPDATED El token no se ha actualizado. ABANDONED Acción abandonada por el comprador (deudor).
El token 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 captura 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 saldo 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. Las transacciones anuladas también se encuentran en el cuadro. - 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.