Recursos para IA
Principales estados y posibles errores
Consulta a continuación los principales estados de una transacción y los posibles errores de solicitud.
Después de la creación exitosa del payout, se generan las transacciones, que corresponden a las transacciones enviadas en el body de la solicitud. Cuando se crea una transacción, o cuando se consulta información relativa a ella, las respuestas retornarán los campos que permitirán conocer el estado en el que se encuentra.
status: este campo proporcionará información sobre el estado actual del procesamiento.status_detail: este campo se encuentra como atributo detransaction.to.accounts, y traerá información sobre los motivos o detalles que resultaron en ese estado.
A continuación puedes ver todos los estados por los que puede pasar una transacción durante su procesamiento.
status | status_detail | Descripción |
approved | - | Se creó una transacción, pero aún no se ha procesado. Es un estado intermedio. |
approved | partially_refunded | La transacción fue parcialmente reembolsada por el banco de destino. |
error | failed | Cuando ocurre un error en el proceso de la transacción y no se logra acreditar el valor en la cuenta de destino. |
processed | approved | El procesamiento de la transacción fue exitoso. |
rejected | by_bank | La transacción fue rechazada por el banco de destino. Ejecuta nuevamente la solicitud. |
rejected | by_provider | La transacción fue rechazada por el proveedor. Ejecuta nuevamente la solicitud. |
rejected | high_risk | La transacción es rechazada debido al riesgo de fraude. Ejecuta nuevamente la solicitud. |
rejected | insufficient_funds | La transacción fue rechazada debido a fondos insuficientes en la cuenta de origen. Ejecuta nuevamente la solicitud. |
rejected | other_reason | La transacción fue rechazada por defecto debido a problemas internos durante el procesamiento. Ejecuta nuevamente la solicitud. |
rejected | review_manual | La transacción es rechazada y enviada para análisis de prevención de fraudes. Ejecuta nuevamente la solicitud. |
refunded | refunded | La transacción fue totalmente reembolsada por el banco de destino. |
success | accredited | La transacción se encuentra acreditada en la cuenta de destino. |
success | in_progress | La acreditación de la transacción está en proceso, aún no está en la cuenta de destino. |
transaction_in_process | pending_authorized | La transacción está en curso, con estado final pendiente y esperando autorización. |
transaction_in_process | pending_bank | El banco de destino no respondió, por lo tanto, la transacción está pendiente de un estado final. |
Si hay un error de solicitud, se retornará un error que indicará el problema que deberá resolverse y, después de eso, el proceso deberá realizarse nuevamente.
| Tipo de Error | Status | Código | Descripción y soluciones posibles |
| Error de solicitud | 400 | GET Transaction invalid_payout_id | Se enviaron datos inválidos en el body de la solicitud. No se encontró el payout. Vuelve a intentar enviar la solicitud, validando todos los campos. |
| Error de solicitud | 400 | GET Transaction invalid_transaction_id | Se enviaron datos inválidos en el body de la solicitud. No se encontró la transacción. Vuelve a intentar enviar la solicitud, validando todos los campos. |
| Error de solicitud | 400 | invalid_signature | Se enviaron datos inválidos en el body de la solicitud. Verifica si la secret fue generada correctamente y está registrada con Mercado Pago. Verifica también si el body que estás enviando es el que fue cifrado. Para más información, accede a Cifrado de seguridad. |
| Error de solicitud | 400 | Idempotency key is required | Se enviaron datos inválidos en el body de la solicitud. El header Idempotency-Key está ausente. Vuelve a intentar enviar la solicitud, validando todos los campos. |
| Error de solicitud | 400 | Invalid chave | El valor del campo transaction.to.accounts[0].chave.value es inválido. Verifica si el valor de la clave Pix es correcto. |
| Error de solicitud | 400 | Invalid chave type | El valor del campo transaction.to.accounts[0].chave.type es inválido. Verifica si el tipo de clave Pix es correcto. |
| Error de solicitud | 400 | Invalid chave pix | La clave Pix es inválida. Verifica el valor ingresado. |
| Error de solicitud | 400 | Chave not found | La clave Pix no fue encontrada. Verifica el valor ingresado. |
| Error de solicitud | 400 | Unsupported chave | La clave Pix no está registrada en Bacen. |
| Error de solicitud | 400 | Chave has a different owner | El valor de la clave Pix no corresponde a la información del titular. |
| Error de solicitud | 400 | Unrecognized key format | El formato de la clave Pix es inválido. Confirma los valores posibles. |
| Error de solicitud | 400 | Invalid identity source | El header X-Identity-Source solo admite dict o ted. |
| Error de solicitud | 400 | Key PSP error | Intento de consultar una clave PSP externa que ya está registrada en Mercado Pago. |
| Error de solicitud | 400 | Invalid Payload | Payload inválido. Verifica el formato de la solicitud. |
| Error de solicitud | 400 | Rate Limit | El servicio de consulta alcanzó el límite de rpm para no superar el límite permitido por el Bacen y no recibir multas. |
| Error de solicitud | 400 | invalid_external_reference | Valor inválido para el campo external_reference. Verifica los valores permitidos para este campo. |
| Error de solicitud | 400 | invalid_type_point_of_interaction | Valor inválido para el campo point_of_interaction.type. Recuerda que es un valor fijo y siempre debe ser {"type":"PSP_TRANSFER"}. |
| Error de solicitud | 400 | invalid_amount | Valor inválido para el campo transaction.from.accounts[0].amount. Verifica los montos permitidos para la transacción. |
| Error de solicitud | 400 | invalid_identification_number | Valor inválido para el campo transaction.to.accounts[0].identification.number. Verifica los valores permitidos. |
| Error de solicitud | 400 | invalid_identification_type | Valor inválido para el campo transaction.to.accounts[0].owner.identification.type. Verifica los valores permitidos. |
| Error de solicitud | 400 | account_is_disabled | La cuenta de Mercado Pago está desactivada. |
| Error de solicitud | 400 | participant_is_not_available | El participante no está habilitado para realizar esta transacción. |
| Error de solicitud | 400 | flow_not_specified | El header X-Flow-id acepta solo transfer o management. |
| Error de solicitud | 400 | compliance_not_processed | La verificación de conformidad no fue concluida para el usuario. |
| Error de solicitud | 400 | invalid_body | El cuerpo de la llamada tiene un formato inválido. Verifica el formato de la solicitud. |
| Error de solicitud | 400 | client_not_allowed | El client_id asociado con las credenciales no tiene permitido realizar la llamada. |
| Error de solicitud | 400 | financial_identity_not_found | La institución financiera no fue encontrada. Revisa el campo to.accounts.bank_id. |
| Error de solicitud | 400 | many_requests | Se realizaron demasiadas llamadas. Espera y vuelve a intentarlo. |
| Error de solicitud | 400 | unauthorized | La llamada no está autorizada. |
| Error de solicitud | 400 | id_format_invalid | El formato del ID en el path de la llamada es inválido. Verifica el ID de la transacción o del payout. |
| Error de solicitud | 401 | Invalid_token | El valor enviado como Access Token es incorrecto. Por favor, verifícalo y vuelve a realizar la solicitud enviando el valor correcto. |
| Error de solicitud | 403 | PolicyAgent | Sin permiso para acceder al recurso. Verifica si el Access Token enviado tiene los permisos necesarios. |
| Error de solicitud | 404 | Transaction not found | El recurso solicitado no fue encontrado o el valor enviado para identificarlo es inexistente. Valida la información enviada en los parámetros y vuelve a intentarlo. |
| Error de solicitud | 412 | Precondition Failed | El estado en el que se encuentra la transacción no permite su cancelación. Solo pueden ser canceladas transacciones con status pending o in_process. |
| Error de la API | 424 | Resource locked | El servicio de rate limit está procesando el consumo de nuestra API por el integrador. Espera e intenta de nuevo. |
| Error de la API | 500 | internal_server_error | Ocurrió un error inesperado en el servidor. Vuelve a intentar la solicitud. Si el problema persiste, contacta al soporte. |
| Error de la API | 502 | bad_gateway | Ocurrió un error en la integración con un servicio externo. Vuelve a intentar la solicitud. Si el problema persiste, contacta al soporte. |