Estado de la transacción y códigos de respuesta

Cada pago tiene una o más transacciones asociadas. La siguiente documentación cubre los tipos de transacciones, los códigos de estado y las descripciones después de que se obtiene un estado HTTP 200 y se procese una transacción.

Flujo de trabajo

Tipos de transacciones

Tipo	Descripción
`PURCHASE`	Una transacción de compra directa.
`AUTHORIZE`	Transacción asociada a la autorización. Principalmente para pagos con tarjeta.
`CAPTURE`	Una captura de una transacción previamente autorizada.
`REFUND`	Un reembolso de una transacción previamente aprobada.
`CANCEL`	Una cancelación de una transacción previamente pendiente.
`VERIFY`	Transacción asociada con una verificación de tarjeta de crédito.
`CHARGEBACK`	Transacción asociada con un contracargo.
`THREE_D_SECURE`	Una transacción de verificación 3DS para una compra inicial.
`FRAUD_SCREENING`	La detección de fraude está asociada con la verificación del fraude.

Códigos de transacción

Con cada transacción, recibirá un response_code detallando más información al respecto. Los detalles relacionados con cada estado se presentan a continuación. Utiliza los siguientes botones para navegar hasta el contenido deseado.

Estado exitoso

Estado ganado

Estado creado

Estatus pendiente

Estado rechazado

Estado de error

Estado caducado

Estado perdido

Estado impedido

Estado exitoso

SUCCEEDED detalles de estado

código_respuesta	Descripción	Declinación dura/suave	Código ISO 8583
`SUCCEEDED`	Transacción exitosa	N/A	0,8,10,11,16,32
`FRAUD_VERIFIED`	Transacción verificada por el proveedor de fraude	N/A	-
`SUCCEEDED_THREE_D_SECURE`	Validación 3DS exitosa	N/A	-

Estado ganado

WON detalles de estado

código_respuesta	Descripción	Declinación dura/suave	Código ISO 8583
`REVIEW_WON`	El adquirente rechazó el contracargo	N/A	-

Estado creado

CREATED detalles de estado

código_respuesta	Descripción	Declinación dura/suave	Código ISO 8583
`ACTION_REQUIRED`	pago creado pero requiere una acción adicional del usuario. Esto ocurre en flujos de autenticación 3D Secure, redirecciones de métodos de pago , flujos Headless SDK que requieren continuePayment o métodos de pago asíncronos con pasos adicionales. Comprueba `redirect_url` o `sdk_action_required` campo para los siguientes pasos.	N/A	-
`SUCCEEDED`	Transacción creada con éxito	N/A	-
`RECEIVED`	Transacción recibida	N/A	-

Estatus pendiente

PENDING detalles de estado

código_respuesta	Descripción	Declinación dura/suave	Código ISO 8583
`CHALLENGE_REQUIRED`	Transacción a la espera de la finalización del desafío	N/A	-
`IN_REVIEW`	La documentación de contracargo se envió al proveedor y se está analizando	N/A	-
`PENDING_FRAUD_REVIEW`	La transacción está siendo analizada por el proveedor de fraude	N/A	-
`PENDING_PROVIDER_CONFIRMATION`	Transacción en espera de confirmación	N/A	-
`PENDING_REVIEW`	Transacción en espera de confirmación de revisión de fraude	N/A	-

Estado rechazado

📘
Algunas de las disminuciones incluyen una merchant_advice_code (MAC) que indica si se debe reintentar y cuándo. Ver Merchant Advice Codes (MAC).

DECLINED detalles de estado

código_respuesta	Descripción	Declinación dura/suave	Código ISO 8583
`ACCOUNT_STATUS`	Póngase en contacto con tu proveedor de fraude para verificar el estado de tu cuenta.	N/A	-
`ACQUIRE_CONTINGENCY`	Adquirir servicio no disponible	SOFT	22, 80, 90, 91, 92, 96
`AUTHENTICATION_ATTEMPT`	Intento de autenticación sin completarse	N/A	-
`AUTHENTICATION_FAILED_THREE_D_SECURE`	Fallo en la validación 3D	N/A	-
`BAD_FILLED_INFO`	La tarjeta no coincide con los parámetros del emisor	HARD	30,89
`BANK_NOT_SUPPORTED`	Banco no compatible con switch	SOFT	31
`CALL_FOR_AUTHORIZE`	El aceptador de la tarjeta llama al departamento de seguridad del adquiriente	SOFT	66
`CANCELLED_BY_USER`	Cancelado por el usuario	SOFT	17
`COUNTRY_NOT_SUPPORTED`	Esta transacción no se puede procesar debido a un país no admitido	HARD	-
`CURRENCY_NOT_ALLOWED`	Moneda no permitida	HARD	-
`DECLINED_BY_BANK`	Rechazado por el banco. Habla con la compañía que le expidió la tarjeta	SOFT	-
`DECLINED_BY_PROVIDER`	Rechazado por el proveedor. Consulta los datos_del_proveedor	SOFT	-
`DISABLED`	Tarjeta restringida	SOFT	-
`DO_NOT_HONOR`	No honrar	SOFT	5
`DUPLICATED_TRANSACTION`	Transmisión duplicada de la transacción	SOFT	26,94
`EXPIRED`	Método de pago alternativo caducado	SOFT
`EXPIRED_CARD`	tarjeta expirada	HARD	33,54
`FIRST_USE`	Primer uso bloqueado	SOFT	78
`FRAUD_VALIDATION`	Violación de seguridad	SOFT	34, 59, 63, 64
`FRAUD_VERIFICATION_DECLINED`	-	-	-
`INSUFFICIENT_FUNDS`	Fondos insuficientes	SOFT	51
`INVALID_AMOUNT`	Monto invalido	SOFT	13,64
`INVALID_CARD_DATA`	La tarjeta no coincide con los parámetros del emisor.	HARD	56
`INVALID_CARD_NUMBER`	La tarjeta no coincide con los parámetros del emisor.	HARD	14
`INVALID_API`	Intentando verificar el pago con una dirección IP no autorizada	HARD	-
`INVALID_API_VERSION`	Versión de API no válida	HARD	-
`INVALID_CREDENTIALS`	Credenciales no válidas del proveedor de fraude establecidas en Yuno.	HARD	-
`INVALID_ISSUER`	Emisor inválido	SOFT	15
`INVALID_MERCHANT`	Comerciante o proveedor de servicios no válido	SOFT	3
`INVALID_PARAMETERS`	parámetros inválidos	HARD	-
`INVALID_SECURITY_CODE`	Código de seguridad de la tarjeta no válido	HARD	56,82
`INVALID_STATUS`	Estado inválido	SOFT	-
`INVALID_RESPONSE_FORMAT`	El cuerpo de la respuesta devuelto por el proveedor tiene un formato no válido	SOFT	-
`INVALID_TRANSACTION`	La transacción que se intenta no es válida	HARD	12,23
`ISSUER_VIOLATION`	El banco emisor rechazó la transacción debido a alguna infracción relacionada con la cuenta.	SOFT	93
`MISSING_PARAMETERS`	Parámetros faltantes	HARD	-
`NO_RETRY_LIFE_CYCLE`	Sin ciclo de vida de reintento	HARD	79
`NO_RETRY_POLICY`	Política de no reintento	HARD	82
`NO_RETRY_SECURITY`	Sin seguridad de reintento	HARD	83
`RETRY_AFTER_1_H`	Inténtalo de nuevo después de 1 hora	HARD
`RETRY_AFTER_24_H`	Inténtalo de nuevo después de 24 horas	HARD
`RETRY_AFTER_2_D`	Inténtalo de nuevo después de 2 días	HARD
`RETRY_AFTER_4_D`	Inténtalo de nuevo después de 4 días	HARD
`RETRY_AFTER_6_D`	Inténtalo de nuevo después de 6 días	HARD
`RETRY_AFTER_8_D`	Inténtalo de nuevo después de 8 días	HARD
`RETRY_AFTER_10_D`	Inténtalo de nuevo después de 10 días	HARD
`REJECTED_THREE_D_SECURE_REQUIRED`	Rechazo de validación 3DS	SOFT	-
`REFER_TO_CARD_ISSUER`	Rechazado por el banco. Habla con la compañía que le expidió la tarjeta	SOFT	01
`REPORTED_LOST`	Tarjeta perdida	HARD	41
`REPORTED_STOLEN`	Tarjeta robada, recogida	HARD	43
`REQUESTS_EXCEEDED`	Se alcanzó el límite de solicitudes para la cuenta del proveedor.	SOFT	-
`RESTRICTED_BY_BANK`	Rechazado por el banco. Consulta las condiciones especiales del emisor de la tarjeta	SOFT	62
`TERMINAL_ERROR`	Tu cuenta de comerciante no está configurada correctamente para la transacción	SOFT	58
`THREE_D_SECURE_REQUIRED`	El proveedor antifraude requiere un desafío 3DS para una validación adicional.	SOFT
`TRANSACTION_NOT_FOUND`	Transacción no encontrada	HARD	25
`UNAVAILABLE_PAYMENT_METHOD`	Función solicitada no admitida	HARD	-
`UNSUPPORTED_OPERATION`	Función solicitada no admitida	HARD	40
`UNKNOWN_ERROR`	Error desconocido	SOFT	-
`USER_RESTRICTION`	Transacción no permitida para el titular de la tarjeta	HARD	57

Merchant Advice Codes (MAC)

Estos códigos le proporcionarán una guía útil al gestionar transacciones rechazadas. Puede encontrar estos campos en las respuestas de nuestra API pública:

transactions.merchant_advice_code y transactions.merchant_advice_code_message:Campos normalizados por Yuno que proporcionan códigos estandarizados y explicaciones sobre la negación.
transactions.provider_data.merchant_advice_code y transactions.merchant_advice_code_message:Código sin procesar y mensaje del proveedor.

Consulte Merchant Advice Codes (MAC) para más información.

Merchant Advice Codes (MAC)

Los Merchant Advice Codes ofrecen orientación de los emisores/proveedores sobre el comportamiento y la política de reintentos. Si se presentan en un rechazo, utilice el MAC para determinar si debe reintentarse y el momento recomendado.

código_consejo_comercial	Descripción	Código MAC del proveedor
`UPDATE_INFORMATION`	Se necesita información actualizada/adicional	01 – Información de cuenta actualizada disponible
`TRY_AGAIN_LATER`	Inténtalo de nuevo después de 10 días	02 – Inténtalo de nuevo más tarde
`DO_NOT_TRY_AGAIN`	No lo intentes de nuevo	03 – No lo intentes de nuevo
`REQUIREMENTS_NOT_FULFILLED`	Requisitos de token no cumplidos	04 – Requisitos de token no cumplidos
`NO_RETRY_LIFE_CYCLE`	Sin ciclo de vida de reintento	21 – Plan recurrente cancelado
`RETRY_AFTER_1_H`	Vuelva a intentarlo después de 1 hora	24 – Reintentar después de 1 hora (fondos insuficientes)
`RETRY_AFTER_24_H`	Inténtalo de nuevo después de 24 horas	25 – Reintentar después de 24 horas (fondos insuficientes)
`RETRY_AFTER_2_D`	Inténtalo de nuevo después de 2 días	26 – Reintentar después de 2 días (fondos insuficientes)
`RETRY_AFTER_4_D`	Inténtalo de nuevo después de 4 días	27 – Reintentar después de 4 días (fondos insuficientes)
`RETRY_AFTER_6_D`	Inténtalo de nuevo después de 6 días	28 – Reintentar después de 6 días (fondos insuficientes)
`RETRY_AFTER_8_D`	Inténtalo de nuevo después de 8 días	29 – Reintentar después de 8 días (fondos insuficientes)
`RETRY_AFTER_10_D`	Inténtalo de nuevo después de 10 días	30 – Reintentar después de 10 días (fondos insuficientes)
`NO_RETRY_POLICY`	Política de no reintento	40 – Tarjeta prepago no recargable
`NO_RETRY_SECURITY`	Sin seguridad de reintento	42 – Puntuación de sanción excedida
`MULTIPLE_USE_CARD`	Tarjeta virtual de usos múltiples	43 – Tarjeta virtual de usos múltiples

Estado rechazado

REJECTED detalles de estado

código_respuesta	Descripción	Declinación dura/suave	Código ISO 8583
`COUNTRY_NOT_SUPPORTED`	-	HARD	-
`CURRENCY_NOT_ALLOWED`	-	HARD	-
`INVALID_PARAMETERS`	-	HARD	-
`INVALID_REQUEST`	-	HARD	-
`INTERNAL_ERROR`	-	HARD	-
`MISSING_PARAMETERS`	-	HARD	-

Estado de error

ERROR detalles de estado

código_respuesta	Descripción	Declinación dura/suave	Código ISO 8583
`ERROR`	Error interno desconocido	SOFT	-
`PROVIDER_ERROR`	Error. Se produjo un error desconocido durante la autorización.	SOFT	6
`PROVIDER_INTERNAL_ERROR`	Error interno	SOFT	98
`PROVIDER_INVALID_CREDENTIALS`	Credenciales no válidas	HARD	-
`PROVIDER_INVALID_REQUEST`	Solicitud no válida	HARD	-
`PROVIDER_TIMEOUT`	Respuesta recibida demasiado tarde	SOFT	68
`PROVIDER_UNKNOWN_ERROR`	Error desconocido	SOFT	-
`OPERATION_NOT_SUPPORTED`	El proveedor no admite esta operación.	HARD	-
`TO_REVERSE`	La transacción será revertida.	HARD	-
`PROVIDER_INVALID_RESPONSE`	Respuesta invalida	HARD	20
`PROVIDER_INVALID_API_VERSION`	Versión de API no válida	HARD	-

Estado caducado

EXPIRED detalles de estado

código_respuesta	Descripción	Declinación dura/suave	Código ISO 8583
`EXPIRED_BY_PROVIDER`	-	N/A	-

Estado perdido

LOST detalles de estado

código_respuesta	Descripción	Declinación dura/suave	Código ISO 8583
`CLOSED`	-	N/A	-
`EXPIRED`	-	N/A	-
`PARTIALLY_CHARGEBACKED`	-	N/A	-
`REVIEW_LOST`	La disputa de contracargo se perdió	N/A	-

Estado impedido

PREVENTED detalles de estado

código_respuesta	Descripción	Declinación dura/suave	Código ISO 8583
`PREVENTED`	Predisputa desviada por proveedor/red. No se requieren pruebas. Terminal.	N/A	-

Nota

PREVENTED sólo es aplicable a las transacciones con type = CHARGEBACK cuando el proveedor/red indica un desvío previo a la disputa. En estos escenarios, Yuno emite únicamente el webhook de devolución de cargo; no se envía ningún webhook de reembolso.

Códigos de respuesta específicos de contracargos

Para obtener más información, consulte la página de códigos de motivo en la sección Guías de devoluciones de cargo.

CREATED detalles de estado

código_respuesta	mensaje_respuesta	Categoría	Descripción
`EMV_LIABILITY_SHIFT_COUNTERFEIT`	Cambio de responsabilidad de EMV Fraude por falsificación	Fraude	El titular de la tarjeta afirma que no autorizó ni participó en una transacción que usted procesó.
`EMV_LIABILITY_SHIFT_NOT_COUNTERFEIT`	Cambio de responsabilidad de EMV Fraude no falsificado	Fraude	El titular de la tarjeta afirma que no autorizó ni participó en una transacción que usted procesó.
`CARD_PRESENT_FRAUD`	Otros fraudes: entorno con presencia de tarjeta	Fraude	El titular de la tarjeta afirma que no autorizó ni participó en una transacción ingresada con clave o sin supervisión realizada en un entorno con tarjeta presente.
`NON_CARD_PRESENT_FRAUD`	Otros fraudes: Entorno sin tarjeta	Fraude	El titular de la tarjeta no autorizó ni participó en una transacción realizada en un entorno sin tarjeta presente, como Internet, pedido por correo, pedido por teléfono y otros.
`SCHEME_MONITORING_PROGRAM`	Otros fraudes - Programa de monitoreo de esquemas	Fraude	Programa de Monitoreo de Esquemas de Fraude
`NO_AUTHORIZATION`	Sin autorización	Autorización	El comerciante no obtuvo una autorización correcta y válida.
`DECLINED_AUTHORIZATION`	Autorización rechazada	Autorización	La solicitud de autorización recibió una respuesta de Rechazo y el comerciante completó la transacción.
`LATE_PRESENTMENT`	Presentación tardía	Errores de procesamiento	La transacción no se envió a Visa dentro del plazo requerido.
`INCORRECT_TRANSACTION_CODE`	Código de transacción incorrecto	Errores de procesamiento	El titular de la tarjeta reclama que el importe convertido del cargo en una transacción internacional es incorrecto.
`INCORRECT_CURRENCY`	Moneda incorrecta	Errores de procesamiento	El comerciante cometió uno o más errores relacionados con la moneda de la transacción
`INCORRECT_ACCOUNT_NUMBER`	Número de cuenta incorrecto	Errores de procesamiento	El número de cuenta en la autorización no coincide con el número de cuenta utilizado en la transacción.
`INCORRECT_AMOUNT`	Cantidad incorrecta	Errores de procesamiento	El titular de la tarjeta alega que el importe que acordó pagar difiere del importe cobrado.
`DUPLICATE_PROCESSING`	Procesamiento de duplicados/Pago por otros medios	Errores de procesamiento	Una sola transacción se procesó dos o más veces.
`INVALID_DATA`	Datos inválidos	Errores de procesamiento	La autorización se obtuvo utilizando datos no válidos o incorrectos.
`PRODUCT_OR_SERVICE_NOT_RECEIVED`	Mercancía/Servicios no recibidos	Disputas de clientes	El titular de la tarjeta reclama que no recibió la mercancía o los servicios que solicitó.
`CANCELED_RECURRING_TRANSACTION`	Transacción recurrente cancelada	Disputas de clientes	Se procesó una transacción recurrente después de ser cancelada.
`PRODUCT_OR_SERVICE_ISSUE`	Mercancía/servicios no descritos o defectuosos	Disputas de clientes	El titular de la tarjeta afirma que los productos no eran como se describían.
`COUNTERFEIT_MERCHANDISE`	Mercancía falsificada	Disputas de clientes	La mercancía fue identificada como falsificada.
`MISREPRESENTATION`	Tergiversación	Disputas de clientes	El banco del titular de la tarjeta recibió una notificación del titular de la tarjeta alegando condiciones de venta tergiversadas.
`CREDIT_NOT_PROCESSED`	Crédito no procesado	Disputas de clientes	El banco del titular de la tarjeta recibió un aviso del titular de la tarjeta alegando que recibió una autorización, un crédito o un recibo de transacción anulado que no ha sido procesado.
`PRODUCT_OR_SERVICE_CANCELED`	Mercancía/Servicios Cancelados	Disputas de clientes	El banco del titular de la tarjeta recibió una notificación del titular de la tarjeta indicando que había devuelto mercancía o cancelado servicios, pero el crédito no apareció en el estado de cuenta Visa del titular de la tarjeta.
`ORIGINAL_TRANSACTION_NOT_ACCEPTED`	Transacción de crédito original no aceptada	Disputas de clientes	El crédito original no fue aceptado.
`CASH_TRANSACTION_VALUE`	No recepción de efectivo o valor de transacción de carga	Disputas de clientes	El titular de la tarjeta no recibió el retiro completo de efectivo en un cajero automático.
`CUSTOMER_AGREEMENT`	Se requiere prueba de transacción o acuerdo del cliente.	Disputas de clientes	El emisor solicita al comerciante una copia del recibo firmado por el titular de la tarjeta o cualquier otra documentación que verifique la aceptación de la compra por parte del cliente. Generalmente, para verificar una transacción con tarjeta presente, el titular la disputa o no la reconoce.