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 Expert.
ACCEPTED Aceptado. Estado de una transacciónVERIFICATIONcuya autorización o verificación de tarjeta 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.
En el caso de transacciones CB o PPRO, este estado indica que se ha solicitado un reembolso. Se están realizando los controles para validar el reembolso.
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 EUR (o solicitud de información en la red de CB si el adquirente lo admite).El vendedor debe validar manualmente la transacción para que se realice la petición de autorización y la captura.
- 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 o pago en
cuotas).
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. - Analice el campo vads_payment_config para determinar si se trata de un pago en cuotas. Si se trata de un pago en cuotas, busque el número de la cuota recuperando el valor del campo vads_sequence_number.
Nombre del campo Solicitud de pago al contado Valor para un pago en cuotas vads_payment_config SINGLE MULTI (cuya sintaxis exacta es MULTI:first=X;count=Y;period=Z)
Al aplicar el rechazo parcial (soft decline), el campo vads_sequence_number ya no permite identificar con facilidad el primer pago de un pago en cuotas. El primer pago puede presentar un número de secuencia distinto de 1, por lo que el número de secuencia del segundo pago no será necesariamente 2.
- 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. vads_change_rate Tasa de cambio utilizada para calcular el monto real del pago. Ver: vads_effective_amount. vads_effective_amount Monto del pago en la divisa realmente utilizada para efectuar la captura. vads_effective_currency Divisa en la que realiza la captura. - 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.Para ayudarle a entender el motivo del rechazo, se presenta una lista de los códigos frecuentemente devueltos:
Valor Descripción 03 Aceptador inválido
Este código lo genera el adquiriente. Se recibe si ha habido un problema de configuración de los servidores de autorización. (ejemplo: contrato terminado, código MCC erróneo, etc.)
Para conocer la razón precisa del rechazo, el vendedor debe contactar a su banco.05 No acepte esta tarjeta Este código lo genera el emisor de la tarjeta. Se recibe en los siguientes casos:
- Fecha de expiración inválida
- CVV inválido
- crédito sobrepasado
- saldo insuficiente
51 Saldo insuficiente o crédito sobrepasado Este código lo genera el emisor de la tarjeta. Se recibe si el comprador no cuenta con un saldo suficiente para realizar su compra.
Para conocer la razón precisa del rechazo, el comprador debe contactar a su banco.56 Tarjeta ausente del archivo Este código lo genera el emisor de la tarjeta.
El número de tarjeta ingresado es incorrecto o el par "número de tarjeta + fecha de vencimiento" no existe.57 Transacción no permitida a este titular de tarjeta Este código lo genera el emisor de la tarjeta. Se recibe en los siguientes casos:
- el comprador intenta realizar un pago por Internet con una tarjeta de retiro
Para conocer la razón precisa del rechazo, el comprador debe contactar a su banco.- el límite autorizado de la tarjeta ha sido superado.
59 Sospecha de fraude Este código lo genera el emisor de la tarjeta. Se recibe tras ingresar varias veces un CVV o fecha de expiración incorrectos.
Para conocer la razón precisa del rechazo, el comprador debe contactar a su banco.60 El aceptador de la tarjeta debe contactar al adquirente
Este código lo genera el adquiriente. Se recibe si ha habido un problema de configuración de los servidores de autorización. Se utiliza cuando el contrato no corresponde al canal de venta utilizado. (ejemplo: una transacción de comercio electrónico con un contrato VAD-manual).
Contacte al servicio al cliente para solucionar este problema.81 El emisor no acepta pagos no seguros
Este código lo genera el emisor de la tarjeta. Al recibir este código, la plataforma de pago realiza automáticamente un nuevo intento de pago con autentificación 3-D Secure cuando es posible.
- 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 Expert (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. ECB Verifica si la tarjeta del comprador es de tipo débito. COMMERCIAL_CARD Verifica si la tarjeta del comprador es una tarjeta empresarial. SYSTEMATIC_AUTO Verifica si la tarjeta del comprador es una tarjeta con autorización sistemática. 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. NON_WARRANTY_PAYMENT Transferencia de responsabilidad. 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. 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: CB,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: "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 Expert.
card_brand Medio de pago utilizado.
Para un pago con tarjeta bancaria (por ejemplo, CB o tarjetas CB de marca compartida Visa o Mastercard), este parámetro tiene el valor"CB".
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 (o RUM para un pago SEPA) se crea con éxito.
NOT_CREATED La solicitud de autorización fue denegada.
El token (o RUM para un pago SEPA)no se crea y no aparecerá en el Back Office Expert.
UPDATED El token (o RUM para un pago SEPA)se actualiza con éxito. NOT_UPDATED El token (o RUM para un pago SEPA)no se ha actualizado. ABANDONED Acción abandonada por el comprador (deudor).
El token (o RUM para un pago SEPA)no se crea y no aparecerá en el Back Office Expert.
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.
