Saltar al contenido principal
Cada pago tiene una o más transacciones asociadas. La siguiente documentación cubre los tipos de transacción, los códigos de estado y las descripciones después de obtener un estado HTTP 200 y de procesar una transacción.

Flujo de trabajo

Tipos de transacciones

Códigos de transacción

Con cada transacción, recibirás un response_code que detalla más información sobre ella. Los detalles relacionados con cada estado se presentan a continuación. Usa los siguientes botones para ir al contenido que necesites. Los detalles de la respuesta del proveedor, cuando están disponibles, aparecen en el objeto provider_data de la transacción. Para reembolsos y cancelaciones, las respuestas síncronas actualmente llenan provider_data.response_code con el código normalizado de Yuno. Las actualizaciones asíncronas pueden llenarlo con el código propio del proveedor, por lo que no se garantiza que este campo contenga el código original del proveedor para estas operaciones. Usa el response_code de la transacción para obtener el resultado normalizado de Yuno. Cuando lo proporciona el proveedor, la respuesta original está disponible en provider_data.raw_response y el mensaje del proveedor está disponible en provider_data.response_message. Su disponibilidad y contenido dependen de la integración. Para consultar a qué corresponde un código específico del proveedor, usa el decodificador de códigos de error de pago. El decodificador es un mapeo de referencia que se mantiene según la documentación publicada de cada proveedor, por lo que debes usarlo como una guía y no como una descripción del comportamiento de una integración específica.

Estado SUCCEEDED

Estado WON

Estado CREATED

Estado PENDING

Estado DECLINED

Estado REJECTED

Estado ERROR

Estado EXPIRED

Estado LOST

Estado PREVENTED

Estado SUCCEEDED

Estado WON

Estado CREATED

Estado PENDING

Estado DECLINED

Algunos rechazos incluyen un merchant_advice_code (MAC) que indica si se debe reintentar y cuándo. Consulta Merchant Advice Codes (MAC).

Merchant Advice Codes (MAC)

Estos códigos proporcionan orientación útil al gestionar transacciones rechazadas. Puedes encontrar estos campos en nuestras respuestas de la 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 el rechazo.
  • transactions.provider_data.merchant_advice_code y transactions.merchant_advice_code_message: código y mensaje sin procesar del proveedor.
Consulta Merchant Advice Codes (MAC) para obtener más información.
Los Merchant Advice Codes proporcionan orientación de los emisores y proveedores sobre el comportamiento y la política de reintentos. Cuando están presentes en un rechazo, usa el MAC para determinar si debes reintentar y el momento recomendado.

Estado REJECTED

Estado ERROR

Estado EXPIRED

Estado LOST

Estado PREVENTED

PREVENTED solo se aplica a las transacciones con type = CHARGEBACK cuando el proveedor o la red indica una desviación de predisputa. En estos escenarios, Yuno emite solo el webhook de contracargo; no se envía ningún webhook de reembolso.

response_codes específicos de contracargos

Para obtener más detalles, consulta la página de códigos de motivo en la sección de guías de contracargos.