Códigos de respuesta HTTP

Esta sección describe los códigos de error comunes y las soluciones que puede encontrar al usar la API de Yuno.

Yuno usa códigos de respuesta HTTP estándar para indicar el éxito o el fracaso de las solicitudes de API.

Los códigos en el rango 2xx generalmente indican éxito. Los códigos en el rango 4xx indican un error que ocurrió según la información proporcionada (por ejemplo, falta un parámetro, etc.) y los códigos en el rango 5xx indican un error interno.

Ejemplo

{
  "code": "INVALID_REQUEST",
  "messages": [
    "Invalid request."
  ]
}

Atributos de respuesta para errores

code string
Atributo para el estado del código de error.

message array de strings
Mensaje de error que se devuelve.

Vea qué códigos devuelve la API Rest de Yuno.

Código de estado HTTP	Código	Descripción
400 Bad Request	`INVALID_REQUEST`	Solicitud no válida.
	`INVALID_PARAMETERS`	Parámetros no válidos: lista - [parameter_name].
	`MISSING_PARAMETERS`	Parámetros que faltan: lista - [parameter_name].
	`INVALID_STATUS`	Estado de transacción no válido.
	`COUNTRY_NOT_SUPPORTED`	País no admitido.
	`CURRENCY_NOT_ALLOWED`	No se admiten divisas para este país.
	`CUSTOMER_ID_DUPLICATED`	El ID de cliente del comerciante está duplicado.
	`INVALID_AMOUNT`	Importe no válido para el método de pago.
	`INVALID_ACCOUNT_ID`	ID de cuenta de Yuno no válido
	`INVALID_TRANSACTION`	ID de transacción no válido
	`INVALID_API_VERSION`	Versión de API no válida.
	`INVALID_TRANSACTION_TYPE`	Tipo de transacción no válido para la solicitud.
	`CHARGEBACK_IN_PROCESS`	Contracargo vigente para esta transacción.
	`UNAVAILABLE_PAYMENT_METHOD`	Método de pago no disponible.
	`NOT_FOUND`	Recurso no encontrado.
	`UNEXPECTED_RESPONSE`	Respuesta de servicio inesperada.
	`BAD_REQUEST`	Hubo un error grave al ejecutar la solicitud.
	`INVALID_REPORT_ID`	El ID del informe debe ser UUID.
	`INVALID_REPORT_TYPE`	Tipo de informe no válido.
	`INVALID_DATE_FORMAT`	El formato de fecha de inicio/finalización debe ser aaaa-MM-dd'T'HH:mm:ss.SSS'Z'.
	`REPORT_MAX_RANGE_ERROR`	La fecha de rango máximo es de dos meses.
	`REPORT_RANGE_ERROR`	La fecha de inicio debe ser anterior a la fecha de finalización. La fecha de inicio/finalización debe ser posterior a ahora.
	`REPORT_STATUS_ERROR`	El informe aún no está listo, el estado es %s.
	`REPORT_EMPTY`	El informe solicitado está vacío.
	`PAYMENT_METHOD_NOT_FOUND`	[Para Suscripciones] - No se encuentra el método de pago asociado al cliente
	`PAYMENT_METHOD_STATUS_INVALID`	[Para suscripciones] - El método de pago es un estado que no permite realizar pagos.
	`INCORRECT_PAYMENT_METHOD_TYPE`	[Para suscripciones] - El tipo de método de pago de la solicitud no corresponde al vaulted_token.
	`SUBSCRIPTION_NOT_FOUND`	[Para suscripciones] - Suscripción no encontrada.
	`INVALID_STATE`	[Para suscripciones] - El estado de la suscripción no admite la acción solicitada.
	`INVALID_DATE`	[Para suscripciones] - No se puede reanudar la suscripción debido a un conflicto con las fechas de disponibilidad. Actualice las fechas de disponibilidad y vuelva a intentarlo si desea seguir utilizando la suscripción.
	`INVALID_PARAMETERS`	[Para suscripciones] - Parámetros no válidos: lista - [nombre_del_parámetro].
	`INVALID_CUSTOMER_FOR_TOKEN`	El token utilizado para esta transacción está asociado con otro objeto de cliente.
	`PAYMENT_NOT_FOUND`	Pago no encontrado.
	`TRANSACTION_NOT_FOUND`	Transacción de pago no encontrada
	`CUSTOMER_NOT_FOUND`	Cliente no encontrado
	`CHECKOUT_SESSION_NOT_FOUND`	Sesión de pago no encontrada o inactiva
	`REPORT_NOT_FOUND`	No se ha encontrado el id del informe
	`IDEMPOTENCY_DUPLICATED`	La idempotencia se duplica.
401 No autorizado	`INVALID_CREDENTIALS`	Credenciales no válidas.
	`EXPIRED_CREDENTIALS`	Credenciales caducadas.
	`UNKNOWN_IP_ADDRESS`	Dirección IP no registrada.
	`INVALID_TOKEN`	Símbolo no válido.
	`TOKEN_IN_USE`	El token proporcionado se está utilizando actualmente en otra solicitud.
403 Prohibido	`AUTHORIZATION_REQUIRED`	El comerciante no tiene autorización para usar esta API.
405 Method not allowed	`UNSUPPORTED_METHOD`	Método no admitido.
500 Internal Server Error	`INTERNAL_ERROR`	Error interno.
504 Tiempo de espera de Gateway	`REQUEST_TIMEOUT`	Pide Timeout.