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

Este endpoint permite obtener los detalles de una transacción de un payout mediante el payout_id y el transaction_id devueltos al crear el payout. En caso de éxito, la solicitud devuelve 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 que contiene la transacción que deseas consultar, devuelto en el campo id de la respuesta a POST /v1/payouts.
transaction_id
string

REQUERIDO

Identificador de la transacción que deseas consultar, devuelto en el campo transactions[].id de la respuesta a POST /v1/payouts.
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.

invalid_account

El objeto `account` se envió sin los datos requeridos para identificar la cuenta de destino. Informa `email` para una cuenta Mercado Pago o los datos bancarios obligatorios de una cuenta externa, incluidos `number` y `bank_id`.

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 solicitud 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"
  }
}