Recursos para IA
Obtener información sobre una transacción

Este endpoint permite obtener información sobre una transacción de Payouts generada previamente en base a su "id". Es decir, podrás consultar información sobre una transacción de salida de dinero proporcionando el número identificador que le fue asignado en la respuesta a su creación. En caso de éxito, la solicitud devolverá una respuesta con el estado 200.

GET

https://api.mercadopago.com/v1/payouts/{payout_id}/transactions/{transaction_id}
Request parameters
Header
Authorization
string

REQUERIDO

Access Token obtenido a través del panel de desarrollador. Obligatorio ser enviado en todas las solicitudes.
Path
payout_id
string

REQUERIDO

Identificador del payout por el que se desea consultar la transacción, devuelto en la respuesta a su creación dentro del campo "id".
transaction_id
string

REQUERIDO

Identificador de la transacción por la que se desea consultar, devuelto en la respuesta a su creación dentro del campo "id".
Response parameters
id
string
Identificador único de la transacción, generado automáticamente.
created_date
string
Fecha de creación de la transacción.
last_update_date
string
Fecha de actualización del estado de la transacción.
external_reference
string
Referencia externa de la transacción, que fue generada por el integrador al momento de crearla.
Errors

400Solicitud inválida. Los parámetros enviados no son válidos.

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.

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.

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.

idempotency_key_required

Se enviaron datos inválidos en el body de la solicitud. La clave de idempotencia ("idempotency_key") está ausente. Vuelve a intentar enviar la solicitud, validando todos los campos.

401Error. Access Token no autorizado.

invalid_token

El valor enviado como Access Token es incorrecto. Por favor, verifícalo y vuelve a intentar realizar la requisición enviando el valor correcto.

403Prohibido. No tiene permisos para acceder a este recurso.

forbidden

Sin permiso para acceder al recurso.

404Error. Payout no encontrado.

not_found

Payout no encontrado. Comprueba si enviaste el ID correcto.

500Error interno del servidor.

internal_server_error

Ocurrió un error inesperado en el servidor. Vuelve a intentar la solicitud.

502Error de gateway. Fallo en la integración con un servicio externo.

bad_gateway

Ocurrió un error en la integración con un servicio externo. Vuelve a intentar la solicitud.

Request
curl -X GET \
    'https://api.mercadopago.com/v1/payouts/{payout_id}/transactions/{transaction_id}'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer APP_USR-4*********994754-12*********c73b4e1ac*********cef36b27c*********840' \
    
Response
{
  "id": "TOP01KKYN1QY2SS1MKAY4G9DV5NK9",
  "created_date": "2024-01-15T10:30:00Z",
  "last_update_date": "2024-01-15T11:00:00Z",
  "external_reference": "000197",
  "status": "created",
  "status_detail": "accredited",
  "type": "TRANSACTION",
  "amount": {
    "currency": "MXN",
    "value": "50.0"
  }
}