Consultar transacción

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.

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

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

---

Ejemplos de respuesta

Éxito

{
  "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

{
  "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 y eliminar funcionan con normalidad.

Ejemplo

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:

{
  "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.

{ "data": [] }

Sin external_id

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