# Consultar transacción

> Devuelve los datos completos de una transacción, por el ID de Rapid o por el ID de tu sistema, incluyendo ítems, cliente, direcciones, pagos y reembolsos.

Página: https://doc.rapidchargeback.com/es/canais/transactions/consultar-transacao/

Devuelve los datos completos de una transacción, incluyendo ítems, cliente, direcciones, pagos y reembolsos. Puedes buscar por el ID que Rapid devolvió en la creación o, si no lo guardaste, [por el ID de tu sistema](#por-el-id-de-tu-sistema).

## Endpoint

```
GET https://api.rapidchargeback.com/api/v1/transactions/:id
```

## Autenticación

```
Authorization: Basic base64(client_id:client_secret)
```

---

## Parámetro de URL

| Parámetro | Tipo | Descripción |
|---|---|---|
| `id` | string (UUID) | ID de la transacción |

---

## Ejemplo de solicitud

```bash
curl -X GET https://api.rapidchargeback.com/api/v1/transactions/00000000-0000-0000-0000-000000000042 \
  -H "Authorization: Basic Y2xpZW50X2lkOmNsaWVudF9zZWNyZXQ="
```

---

## Ejemplos de respuesta

### Éxito

```json
{
  "data": {
    "id": "00000000-0000-0000-0000-000000000042",
    "company_id": "00000000-0000-0000-0000-0000000000c1",
    "merchant_id": "00000000-0000-0000-0000-000000000001",
    "external_id": "TXN-2026-001",
    "external_source": "shopify",
    "order_number": "ORD-001",
    "auth_code": "AUTH999",
    "arn": null,
    "network": "visa",
    "amount": "150.00",
    "currency": "USD",
    "transaction_date": "2026-04-01T15:30:00.000Z",
    "card_bin": "424242",
    "card_last4": "4242",
    "descriptor": "LOJA EXEMPLO",
    "ip_address": "203.0.113.10",
    "created_at": "2026-04-01T15:31:00.000Z",
    "updated_at": "2026-04-01T15:31:00.000Z",
    "transaction_items": [
      {
        "id": "...",
        "product_description": "Assinatura Premium - Mensal",
        "product_name": "Plano Premium",
        "quantity": 1,
        "unit_price": "150.00"
      }
    ],
    "transaction_customers": [
      {
        "id": "...",
        "first_name": "João",
        "last_name": "Silva",
        "email": "joao@exemplo.com"
      }
    ],
    "transaction_addresses": [
      {
        "id": "...",
        "type": "shipping",
        "street": "Rua das Flores",
        "number": "123",
        "city": "São Paulo",
        "state": "SP",
        "postal_code": "01001000",
        "country": "BRA"
      }
    ],
    "transaction_payments": [],
    "transaction_refunds": []
  }
}
```

### Transacción no encontrada

```json
{
  "error": {
    "code": "TRANSACTION_NOT_FOUND",
    "message": "Transaction not found"
  }
}
```

---

## Por el ID de tu sistema

Si no guardaste el `id` que Rapid devolvió en la creación, encuentra la transacción por el identificador que **tú** enviaste: `external_source` más `external_id`. Es la misma combinación que impide duplicados en la creación, así que la respuesta trae **como máximo una** transacción.

```
GET https://api.rapidchargeback.com/api/v1/transactions?external_source=shopify&external_id=TXN-2026-001
```

| Param | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `external_id` | string (hasta 100) | Sí | El `external_id` enviado en la creación |
| `external_source` | string (hasta 50) | No | El `external_source` enviado en la creación. Sin él, vale `custom`, el mismo valor por defecto de la creación |

Esto **no** es un listado de transacciones: sin `external_id` la respuesta es `422`. Con el `id` en mano, [actualizar](https://doc.rapidchargeback.com/es/canais/transactions/atualizar-transacao/) y [eliminar](https://doc.rapidchargeback.com/es/canais/transactions/deletar-transacao/) funcionan con normalidad.

### Ejemplo

```bash
curl -G "https://api.rapidchargeback.com/api/v1/transactions" \
  --data-urlencode "external_source=shopify" \
  --data-urlencode "external_id=TXN-2026-001" \
  -H "Authorization: Basic Y2xpZW50X2lkOmNsaWVudF9zZWNyZXQ="
```

### Encontrada

`200` con una lista de un ítem, en el mismo formato de la consulta por ID:

```json
{
  "data": [
    {
      "id": "00000000-0000-0000-0000-000000000042",
      "external_source": "shopify",
      "external_id": "TXN-2026-001",
      "...": "demás campos, como en la consulta por ID"
    }
  ]
}
```

### No encontrada

`200` con la lista vacía. Una transacción de otra empresa también vuelve vacía: la búsqueda es siempre dentro de la tuya.

```json
{ "data": [] }
```

### Sin `external_id`

```json
{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "external_id is required"
  }
}
```