Consultar transação

Retorna os dados completos de uma transação, incluindo itens, cliente, endereços, pagamentos e reembolsos. Dá para buscar pelo ID que a Rapid devolveu na criação ou, se você não guardou, pelo ID do seu sistema.

Endpoint

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

Autenticação

Authorization: Basic base64(client_id:client_secret)

---

Parâmetro de URL

Parâmetro	Tipo	Descrição
id	string (UUID)	ID da transação

---

Exemplo de requisição

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

---

Exemplos de resposta

Sucesso

{
  "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": []
  }
}

Transação não encontrada

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

---

Pelo ID do seu sistema

Se você não guardou o id que a Rapid devolveu na criação, ache a transação pelo identificador que você enviou: external_source mais external_id. É a mesma combinação que impede duplicata na criação, então a resposta tem no máximo uma transação.

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

Param	Tipo	Obrigatório	Descrição
external_id	string (até 100)	Sim	O external_id enviado na criação
external_source	string (até 50)	Não	O external_source enviado na criação. Sem ele, vale custom, o mesmo padrão da criação

Isto não é uma listagem de transações: sem external_id a resposta é 422. Com o id em mãos, atualizar e deletar funcionam normalmente.

Exemplo

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

Achou

200 com uma lista de um item, no mesmo formato da consulta por ID:

{
  "data": [
    {
      "id": "00000000-0000-0000-0000-000000000042",
      "external_source": "shopify",
      "external_id": "TXN-2026-001",
      "...": "demais campos, como na consulta por ID"
    }
  ]
}

Não achou

200 com a lista vazia. Transação de outra empresa também volta vazia: a busca é sempre dentro da sua.

{ "data": [] }

Sem external_id

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