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.
PRE_AUTHORISED Pre-autorizado
Cuando el contrato comercial ha sido configurado en modo "preautorización", todos los pagos se realizan con una petición de autorización de 30 días
Durante este periodo, el vendedor puede modificar el monto a la alza, una sola vez y hasta un 199% del monto inicial. También puede modificar la fecha de captura para capturar la transacción antes de la fecha de expiración de la preautorización.
Al alcanzar la fecha de captura, el estado de la transacción pasa de PRE_AUTHORISED a CAPTURED.
Los pagos realizados en modo "preautorización" no se pueden pagar en cuotas.
REFUSED Rechazado
La transacción ha sido rechazada.
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.
- 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 tipo de tarjeta utilizada para el pago. Se pueden presentar dos casos:
- En el caso de un pago realizado con una sola tarjeta. Los campos que se deben procesar son los siguientes:
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). - Para un pago fraccionado (es decir, una
transacción que utiliza varios medios de pago), los campos que se deben
procesar 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" : ID de la transacción global en la secuencia de pago.
- "transaction" : tabla de las transacciones de la secuencia. Los elementos que componen la tabla son los siguientes:
Primer apellido 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 devuelve si no es aplicable al medio de pago
Ejemplo: 949478
auth_result Código de retorno de la petición de autorización. capture_delay Plazo antes de la captura - Para un pago con tarjeta bancaria, el valor de este parámetro considera el plazo en cantidad de días antes de la captura. Si este parámetro no se transmite en el formulario de pago, se utiliza el valor predeterminado definido en Back Office Vendedor.
card_brand Medio de pago utilizado.
Consulte la guía de integración del formulario de pago disponible en nuestro sitio documental para visualizar la lista completa de los tipos de tarjeta.
card_number El número del medio de pago
expiry_month Mes de expiración del medio de pago.
expiry_year Año de expiración del medio de pago.
payment_certificate durante el pago. contract_used Contrato utilizado para el pago. identifier ID único (token/alias) asociado a un medio de pago. identifier_status Presente solo si la acción solicitada es crear o actualizar un token. 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 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 de la transacción generada por la plataforma de pago después de la creación de una transacción de pago. Ofrece una garantía de unicidad para cada transacción.
extra_result Código numérico del resultado de los controles de riesgo. Code Descripción Vacío No se ha realizado ningún control. 00 Todos los controles fueron satisfactorios. 02 La tarjeta ha superado el saldo autorizado 03 La tarjeta se encuentra en la lista gris del vendedor. 04 El país de emisión de la tarjeta se encuentra en la lista gris del vendedor. 05 La dirección IP se encuentra en la lista gris del vendedor. 06 El código BIN se encuentra en la lista gris del vendedor. 07 Detección de tarjetas de débito electrónica. 08 Detección de una tarjeta empresarial nacional. 09 Detección de una tarjeta empresarial extranjera. 14 Detección de tarjetas con autorización sistemática. 20 Verificación de coherencia: 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 se encuentra en la lista gris del vendedor. 99 Ha surgido un problema técnico en 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 la tabla - 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.