Recursos para IA
Posibles errores
Consulta la lista de posibles errores devueltos por la API de Orders y cómo corregirlos.
| Tipo de error | Status | Código | Descripción y soluciones posibles |
| Error de solicitud | 400 | json_syntax_error | Asegúrate de que la solicitud tenga una estructura JSON válida, con claves y valores adecuados. |
| Error de solicitud | 400 | required_properties | Algunas propiedades obligatorias están ausentes. Verifica la solicitud y asegúrate de incluir todas las propiedades requeridas según la documentación de la API. |
| Error de solicitud | 400 | unsupported_properties | Algunas propiedades informadas no son soportadas por la API. Revisa la solicitud y elimina o corrige las propiedades no soportadas. |
| Error de solicitud | 400 | minimum_properties | No se ha cumplido el número mínimo de propiedades requeridas. Agrega las propiedades necesarias para completar la solicitud. |
| Error de solicitud | 400 | property_type | El tipo de la propiedad informada es inválido. Asegúrate de que el valor enviado en la solicitud corresponda al tipo esperado. |
| Error de solicitud | 400 | property_value | El valor de la propiedad informada es inválido. Verifica el valor enviado y haz los ajustes para que corresponda a los valores permitidos. |
| Error de solicitud | 400 | maximum_items | Se ha excedido el número máximo de ítems permitidos. Reduce la cantidad de ítems enviados para que no sobrepase el máximo permitido. |
| Error de solicitud | 400 | minimum_items | No se ha cumplido el número mínimo de ítems requerido. Agrega más ítems a la solicitud para cumplir con los requisitos de la API. |
| Error de solicitud | 400 | invalid_path_param | Verifica si el ID proporcionado como parámetro es válido. |
| Error de solicitud | 400 | invalid_properties | Algunas propiedades informadas son inválidas o están mal formadas. Revisa las propiedades enviadas y verifica si están de acuerdo con las especificaciones de la API. |
| Error de solicitud | 400 | empty_required_header | Uno o más headers obligatorios están vacíos. Verifica la solicitud y asegúrate de que todos los headers requeridos están presentes y debidamente completados. |
| Error de solicitud | 400 | invalid_idempotency_key_length | El valor enviado en el header X-Idempotency-Key excedió el tamaño máximo permitido. El header acepta valores entre 1 y 64 caracteres. |
| Error de solicitud | 400 | order_builder_without_transactions | No hay una transacción asociada a la order. Asegúrate de incluir al menos una transacción para la creación de la order. |
| Error de solicitud | 400 | invalid_order_mode_for_operation | El modo informado no es válido para esta operación. Verifica si estás utilizando el modo correcto según la operación deseada. |
| Error de solicitud | 400 | invalid_order_type | El tipo de la order es inválido. Verifica si el tipo utilizado es válido para la operación. |
| Error de solicitud | 400 | invalid_transaction_id | El ID de la transacción es inválido. Asegúrate de que el ID es correcto. |
| Error de solicitud | 400 | exceeded_number_of_transactions | Ocurrió un error en la solicitud. La Order acepta un máximo de una transacción. Elimina las transacciones excedentes. |
| Error de solicitud | 400 | invalid_email_for_sandbox | El formato de correo electrónico no es válido para el entorno de sandbox, debe contener "@testuser.com". |
| Error de solicitud | 400 | order_invalid_sponsor_id | El identificador del patrocinador de la order es inválido. Asegúrate de que el ID sea correcto. |
| Error de solicitud | 400 | invalid_header_value | Identificador del llamador (caller_id) no encontrado. Asegúrate de que el ID sea correcto. |
| Error de solicitud | 401 | 401 | El valor enviado como Access Token es incorrecto. Por favor, verifícalo y vuelve a intentar realizar la requisición enviando el valor correcto. |
| Error de solicitud | 401 | invalid_credentials | No hay soporte para credenciales de prueba. Usa usuarios de prueba con credenciales de producción para el entorno de prueba (sandbox) y tus credenciales de producción para el entorno de producción. |
| Error de procesamiento | 402 | failed | Hubo un error en el procesamiento de alguna de las transacciones. Verifica el mensaje devuelto para más información. |
| Error de solicitud | 404 | order_not_found | La order no fue encontrada. Verifica si el ID informado es correcto. |
| Error de solicitud | 404 | transaction_not_found | La transacción no fue encontrada. Verifica si el ID informado es correcto. |
| Error de solicitud | 409 | cannot_refund_order | Asegúrate de que la order esté en un estado que permita la realización de un reembolso. |
| Error de solicitud | 409 | cannot_capture_order | Verifica si el estado de la order permite la captura y que esta haya sido creada con el campo processing_mode definido como automatic. |
| Error de solicitud | 409 | cannot_cancel_order | Asegúrate de que la order esté en un estado que permita su cancelación. |
| Error de idempotencia | 409 | idempotency_key_already_used | La clave X-Idempotency-Key proporcionada ya ha sido utilizada. Cada clave de idempotencia debe ser única para garantizar que la operación se realice una única vez. Utiliza una nueva clave para la próxima solicitud. |
| Error de solicitud | 409 | operation_not_supported | La operación solicitada no es soportada. Verifica si la operación que estás tratando de realizar es válida para el contexto actual. |
| Error de solicitud | 409 | order_already_refunded | La order informada ya fue reembolsada. No es posible procesar un reembolso en una order que ya tiene este estado. |
| Error de solicitud | 409 | order_already_canceled | La order informada ya fue cancelada. No es posible realizar operaciones en una order que ya se encuentra cancelada. |
| Error de solicitud | 409 | order_refund_already_in_process | Ya existe una solicitud de reembolso completo en proceso para la order en cuestión. |
| Error de idempotencia | 423 | resource_locked | La clave de idempotencia está temporalmente bloqueada. Espera unos instantes y trata de ejecutar la solicitud nuevamente. |
| Error de idempotencia | 500 | idempotency_validation_failed | Ocurrió un error interno en el servidor. Intenta reenviar la solicitud con una clave de idempotencia nueva y única para evitar conflictos. Si el problema persiste, comunícate con Soporte y proporciona el x-request-id junto a más detalles sobre la operación realizada. |
| Error de la API | 500 | internal_error | Ocurrió un error interno en el servidor. Por favor, intenta nuevamente más tarde. Si el problema persiste, comunícate con Soporte y proporciona el x-request-id junto a más detalles sobre la operación realizada. |
| Error de solicitud | 400 | invalid_sequence_control | No es posible crear el pago enviando la información del nodo automatic_payments.subscription.sequence utilizando un perfil de pago con sequence_control definido como AUTO. El valor de este campo debe ser definido como MANUAL para enviar la información relativa a la recurrencia. Accede a Gestionar pagos con recurrencia programada para más información. |
| Error de solicitud | 400 | invalid_payment_methods | El perfil de pago con el que se está queriendo crear la order no tiene asociados medios de pago, o bien tiene dos tarjetas y la order está queriendo ser procesada con el modo síncrono, lo que no está permitido. Revisa su configuración para volver a intentarlo. |
| Error de solicitud | 400 | invalid_capture_mode | La order tiene configurada la lógica de reintentos pero el modo de procesamiento está definido como automatic. El campo retries solo será permitido en caso de que se haya definido processing_mode=automatic_async. |
| Error de solicitud | 400 | invalid_payment_method_list | El perfil de pago con el que se está queriendo crear la order tiene asociados más de dos medios de pago, que es la cantidad máxima permitida. Revisa su configuración para volver a intentarlo. |
| Error de solicitud | 400 | invalid_application_id | El identificador de la aplicación con la que se está queriendo ejecutar la solicitud es incorrecto o no está autorizado. Verifica estar enviando la información correcta. |
| Error de solicitud | 400 | profile_not_found | El perfil de pago con el que se está queriendo crear el pago no existe o es inválido. Verifica haber enviado el valor correcto y vuelve a intentarlo. |
| Error de solicitud | 400 | invalid_profile_status | Se está queriendo crear la order utilizando un perfil de pago con un estado que no lo permite. Solo es posible crear pagos con perfiles de pago con status=READY. Verifica el estado del perfil utilizando la API de Perfiles. |
| Error de solicitud | 400 | invalid_customer_id | El identificador del cliente enviado en la solicitud no coincide con el del perfil de pago. Verifica haber enviado los valores correctos en ambos casos. |
| Error de solicitud | 400 | invalid_collector_with_application_fee | Debe enviarse un application_fee mayor a 1 para que la solicitud sea correcta. |
| Error de solicitud | 404 | profile_not_found | El perfil de pago con el que se está queriendo crear el pago no fue encontrado. Verifica haber enviado el valor correcto y vuelve a intentarlo. |
| Error de solicitud | 400 | profile_id_must_be_informed | No fue enviado el identificador del perfil, que es obligatorio en los casos en los que sequence_control.reason=recurring. |
| Error de solicitud | 400 | invalid_intent_status | No es posible reembolsar la order en su estado actual. Asegúrate de que la order esté en un estado que permita la realización de un reembolso. |
| Error de solicitud | 400 | invalid_refund_amount | No es posible reembolsar el monto definido en la solicitud. Asegúrate haber enviado el valor correcto. |
| Error de solicitud | 400 | refund_error | Hubo un error al intentar procesar el reembolso. Espera un momento y vuelve a intentarlo. |
| Error de solicitud | 400 | invalid_refund | Se está queriendo reembolsar un pago que no lo permite. Asegúrate cumplir con las condiciones para crear un reembolso y vuelve a intentarlo. |
| Error de la API | 424 | error_dependency | Ocurrió un error interno. Espera un momento y vuelve a intentarlo. |