Recursos para IA
Posibles errores
Consulta la lista de posibles errores devueltos por las APIs utilizadas en la integración con Wallet Connect y cómo corregirlos.
Errores devueltos en las operaciones de creación de la vinculación, generación del token de pago, consulta y cancelación.
| Tipo de Error | Status | Código | Descripción y posibles soluciones |
| Error de solicitud | 400 | RedirectUriMismatch | La URI de redirección no coincide con la registrada para esta aplicación. Verifica el valor enviado en return_uri y confirma que esté registrado en las configuraciones de tu aplicación. |
| Error de solicitud | 400 | ReturnUriNull | El campo return_uri es requerido y no fue enviado. Vuelve a realizar la solicitud incluyéndolo. |
| Error de solicitud | 400 | ReturnUriTooLong | El valor de return_uri excede la longitud máxima permitida de 2048 caracteres. Reduce el tamaño de la URI enviada. |
| Error de solicitud | 400 | ExternalUserNull | El campo external_user es requerido y no fue enviado. Vuelve a realizar la solicitud incluyendo el identificador del comprador en tu sistema. |
| Error de solicitud | 400 | ExternalFlowIdTooLong | El valor de external_flow_id excede la longitud máxima permitida de 64 caracteres. Reduce el tamaño del identificador enviado. |
| Error de solicitud | 400 | AgreementDataDescriptionInvalid | El valor de agreement_data.description es inválido. Verifica el contenido enviado y respeta el límite de 256 caracteres. |
| Error de solicitud | 400 | CodeMismatch | El código proporcionado no coincide con el código de validación de esta vinculación. Utiliza el code devuelto en la return_uri o en el webhook de confirmación de la vinculación correspondiente. |
| Error de solicitud | 400 | InvalidCodeFormat | El formato del código es inválido. Debe ser una string alfanumérica de 32 caracteres en minúsculas. |
| Error de solicitud | 400 | AlreadyCreated | Ya se generó un token de pago para esta vinculación. Utiliza el payer_token obtenido anteriormente, ya que el mismo code no puede reutilizarse. |
| Error de solicitud | 400 | WindowExpired | La ventana de tiempo para generar un token de pago ha expirado. Será necesario crear una nueva vinculación y obtener una nueva aprobación del comprador. |
| Error de solicitud | 400 | AgreementNotConfirmedByUser | El comprador aún no ha confirmado la vinculación. Espera la conclusión del flujo de aprobación antes de solicitar el token de pago. |
| Error de solicitud | 400 | UserIdEqualsCollectorId | El comprador y el vendedor no pueden ser el mismo usuario de Mercado Pago. Utiliza cuentas distintas para realizar la vinculación. |
| Error de solicitud | 400 | invalid_path_param | El agreement_id proporcionado en el path no es válido. Compruébalo y proporciona un ID válido para volver a intentarlo. |
| Error de solicitud | 403 | forbidden | No tienes permiso para acceder al recurso solicitado. Verifica si el Access Token utilizado tiene los permisos y alcances necesarios para esta operación. |
| Error de solicitud | 404 | AgreementNotFound | No se encontró ninguna vinculación con el ID proporcionado. Esta misma respuesta se devuelve cuando la vinculación pertenece a otra aplicación, a fin de evitar exponer la existencia de vinculaciones de otros clientes. |
| Error de solicitud | 404 | ClientNotOwner | La vinculación existe pero no fue creada por la aplicación actual. Se devolverá la misma respuesta AgreementNotFound para evitar exponer la existencia de vinculaciones de otros clientes. |
| Error de solicitud | 404 | AlreadyCancelled | La vinculación ya fue cancelada. Recuerda que también puede ser cancelada por el propio comprador a través de la aplicación de Mercado Pago o automáticamente cuando se confirma una nueva vinculación para el mismo comprador. |
| 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, contacta al soporte, proporciona el x-request-id y más detalles sobre la operación realizada. |
Errores devueltos en las operaciones de creación, captura, consulta, cancelación y reembolso de orders.
| Tipo de Error | Status | Código | Descripción y posibles soluciones |
| Error de solicitud | 400 | json_syntax_error | Se envió un JSON inválido. Asegúrate de que la solicitud posea una estructura JSON válida y verifica el mensaje devuelto en los detalles del error para identificar el problema. |
| Error de solicitud | 400 | required_properties | Algunas propiedades obligatorias están ausentes. Verifica el mensaje devuelto en los detalles del error y asegúrate de incluir todas las propiedades requeridas conforme a la documentación de la API. |
| Error de solicitud | 400 | unsupported_properties | Se envió una propiedad no soportada por la API. Revisa la solicitud y elimina o corrige las propiedades no soportadas. |
| Error de solicitud | 400 | minimum_properties | No se envió 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 alguna 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 alguna propiedad informada es inválido. Verifica el valor enviado y ajústalo para que corresponda a los valores permitidos. |
| Error de solicitud | 400 | maximum_items | El tamaño del array excede el máximo permitido. Reduce la cantidad de ítems enviados. Recuerda que las orders de Wallet Connect aceptan solamente una transacción de pago. |
| Error de solicitud | 400 | minimum_items | El tamaño del array está por debajo del mínimo permitido. Agrega más ítems a la solicitud para cumplir con los requisitos de la API. |
| Error de solicitud | 400 | invalid_properties | Se proporcionó información incorrecta. Revisa las propiedades enviadas y verifica si están de acuerdo con las especificaciones de la API. |
| Error de solicitud | 400 | invalid_path_param | El order_id proporcionado en el path no es válido. Compruébalo y proporciona un id válido para volver a intentarlo. |
| Error de solicitud | 400 | invalid_order_type | El type de la order es inválido o no soportado. Para pagos con Wallet Connect, el único valor posible es online. |
| Error de solicitud | 400 | invalid_total_amount | El valor informado en total_amount no equivale a la suma del campo transactions.payments.amount del total de transacciones. Verifica si los valores son correctos. |
| Error de solicitud | 400 | empty_required_header | El header X-Idempotency-Key es obligatorio y no fue enviado. Vuelve a realizar la solicitud incluyéndolo. |
| Error de solicitud | 400 | invalid_idempotency_key_length | El valor enviado en el header X-Idempotency-Key debe tener entre 1 y 64 caracteres. |
| Error de solicitud | 400 | refund_amount_exceeds | El monto del reembolso es mayor que el monto disponible en la transacción. Verifica el monto disponible y ajusta el valor solicitado para no exceder ese límite. |
| Error de autenticación | 401 | unauthorized | El valor enviado como Access Token es incorrecto. Verifícalo e intenta enviar la solicitud nuevamente con el valor correcto. |
| Error de autenticación | 401 | unauthorized_payer_token | El payer_token proporcionado no está autorizado para esta transacción. Verifica si el token es válido, si pertenece al comprador autenticado y si la vinculación no fue cancelada. Si lo fue, es necesario repetir el flujo de vinculación. |
| Error de autenticación | 401 | invalid_credentials | No hay soporte para credencialesClaves de acceso únicas que usamos para identificar una integración en tu cuenta, vinculadas a tu aplicación. Para más información, accede al enlace a continuación.Credenciales de prueba. Utiliza 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 | La order fue creada pero alguna transacción falló. Verifica el campo errors de la respuesta para identificar el motivo, como saldo insuficiente en la billetera del comprador (insufficient_amount). |
| Error de solicitud | 404 | order_not_found | Order no encontrada. Verifica si el id enviado es correcto. |
| Error de solicitud | 404 | payment_not_found | Pago no encontrado. Verifica si el payment_id enviado es correcto. |
| Error de solicitud | 404 | transaction_not_found | Transacción no encontrada. Verifica si el transaction_id enviado es correcto. |
| Error de Idempotencia | 409 | idempotency_key_already_used | El valor enviado como header de idempotencia (X-Idempotency-Key) ya fue utilizado. Cada clave debe ser única para garantizar que la operación se realice una sola vez. Utiliza un nuevo valor para la próxima solicitud. |
| Error de solicitud | 409 | operation_not_supported | La operación no es soportada para esta order. Verifica el status y el status_detail de la order e intenta nuevamente. |
| Error de solicitud | 409 | cannot_capture_order | La order no puede ser capturada porque no está en un status que permita la captura. Solamente orders en el status action_required creadas con capture_mode igual a manual pueden ser capturadas. |
| Error de solicitud | 409 | cannot_cancel_order | La order no puede ser cancelada porque no está en un status que permita la cancelación. Solamente orders en el status action_required pueden ser canceladas. Para revertir un pago ya capturado, utiliza el reembolso. |
| Error de solicitud | 409 | order_already_canceled | La order ya fue cancelada. No es posible realizar operaciones en una order que ya se encuentra en ese status. |
| Error de solicitud | 409 | cannot_refund_order | La order no puede ser reembolsada. Asegúrate de que esté en un status que permita la realización de un reembolso. |
| Error de solicitud | 409 | order_already_refunded | La order ya fue totalmente reembolsada. No es posible procesar un nuevo reembolso en ese escenario. |
| Error de solicitud | 409 | order_refund_already_in_process | Ya existe en procesamiento una solicitud de reembolso completo para esta order. Espera su conclusión antes de enviar una nueva solicitud. |
| Error de solicitud | 422 | unprocessable_entity | El perfil de pago asociado al payer_token está corrompido o incompleto. Solicita al comprador que rehaga la vinculación de la billetera. |
| Error de Idempotencia | 423 | resource_locked | La clave de idempotencia (X-Idempotency-Key) está bloqueada por una solicitud en curso. Espera algunos instantes e intenta ejecutar la solicitud nuevamente. |
| Error de Idempotencia | 500 | idempotency_validation_failed | Falla en la validación de idempotencia. Intenta reenviar la solicitud con una clave de idempotencia nueva y única para evitar conflictos. Si el problema persiste, contacta al soporte, proporciona el x-request-id y 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, contacta al soporte, proporciona el x-request-id y más detalles sobre la operación realizada. |
Para obtener más información sobre cómo enviar las solicitudes, requisitos y validaciones necesarias, consulta nuestra Referencia de APIAPI.