GET/api/Transaction/transactionByTransactionId/{transactionId}

Buscar Transação por ID

Recupera todos os detalhes de uma transação PIX, incluindo os dados reais retornados pela A55 (consulta de status do QR Code Dinâmico).

Endpoint

GET https://api.splitgames.com.br/api/Transaction/transactionByTransactionId/{transactionId}

Path Parameters

transactionIdstring (UUID)

ID único da transação

Headers

X-Client-IdObrigatório

<client_id>

X-API-KeyObrigatório

<api_key>

Response

200 - Sucesso

Retorna os dados da transação + os dados reais do QRCode retornados pela A55.

{
  "data": {
    "id": "56fa5704df0f4fb2a140b42a54",
    "status": "PAID",
    "paymentMethod": "PIX",
    "amount": 1000,
    "description": "Transação PIX",
    "qrCode": "00020101021226820014br.gov.bcb.pix2560qrcode.pagsm.com.br/...",
    "qrCodeUrl": null,

    "customer": {
      "name": "Martins teste",
      "email": "Martins@gmail.com",
      "document": "12312312312312"
    },

    "pix": {
      "chavePix": "c32361fa-44de-4be7-815f-0e782a10860c",
      "recebedorNome": "WL Store",
      "solicitacaoPagador": "Pagamento PIX",
      "devedorDocumento": "12312312312312",
      "devedorNome": "Martins teste",
      "cidade": "SaoPaulo",
      "cep": "01001000",
      "valorOriginal": 10,
      "modalidadeAlteracao": "NaoPermiteAlteracao",
      "expiracaoQR": 86400,
      "txId": "56fa5704df0f4fb2a140b42a54",
      "dadosAdicionais": [],
      "reutilizavel": false,
      "urlPayloadJson": "qrcode.pagsm.com.br/pix/1c0cb89b-6470-40d2-acbe-11fec26f81d6",
      "payloadBase64": "MDAwMjAxMDEwMjEyMjY4MjAwMTRi...",
      "revisao": 0,
      "situacao": "Liquidado",
      "liquidadoEm": "2025-11-21T12:52:20.916733-03:00",
      "endToEndIdRecebimento": "E18236120202511211551s0753f685ce",
      "valorPago": 10
    },

    "metadata": null,
    "createdAt": "2025-11-21T15:50:57.969676",
    "paidAt": "2025-11-21T15:52:26.579474+00:00"
  },
  "status": 200,
  "message": "Transação recuperada com sucesso."
}

404 - Not Found

{
  "type": "https://api.splitgames.com.br/errors/not-found",
  "title": "Not Found",
  "status": 404,
  "detail": "Transação não encontrada.",
  "instance": "/api/Transaction/transactionByTransactionId/..."
}

Exemplo de Requisição

curl -X GET https://api.splitgames.com.br/api/Transaction/transactionByTransactionId/56fa5704df0f4fb2a140b42a54 \
  -H "X-Client-Id: seu-client-id" \
  -H "X-API-Key: sua-api-key"