Consultar transações

Para consultar uma transação, use o serviço de consulta da API do Gateway de Pagamento, informando o PaymentId da transação. Você pode consultar uma transação para verificar todos os dados dessa transação ou para saber o seu status.

ℹ️
Vá para o manual do Gateway de Pagamento para visualizar os endpoints de consulta.

ℹ️
CNPJs alfanuméricos serão implementados pela Receita Federal em julho de 2026
Essa mudança afeta apenas novas inscrições, não havendo mudanças em CNPJs existentes.
O CNPJ alfanumérico já está sendo suportado pela Cielo, sem mudanças na sua integração.
Recomendamos verificar a necessidade de possíveis ajustes nos sistemas próprios de checkout de sua loja.

Use a consulta por PaymentId para recuperar o IssuerTransactionId e o TransactionLinkId da transação CIT quando a loja não os tiver armazenado. Saiba mais em Identificadores da bandeira para adquirente Cielo.

TLID Mastercard

O Transaction Link Identifier (TLID), enviado e retornado no campo TransactionLinkId, é um identificador único gerado pela bandeira Mastercard durante uma transação CIT, usado para vincular as transações MIT relacionadas. O TLID vale para a resposta do VerifyCard (apenas resposta) e para as transações de crédito, débito e recorrência.

Na Mastercard, envie IssuerTransactionId e TransactionLinkId juntos nas transações MIT: os dois parâmetros são obrigatórios.

Fase	Descrição
Fase 1	Vigente. O campo `TransactionLinkId` está disponível na resposta da validação de cartão por VerifyCard, criação de pagamento com cartão de crédito, criação de pagamento com cartão de débito e na consulta por `PaymentId`.
Fase 2	Envio obrigatório do `TransactionLinkId` no request (MIT) a partir de 23/10/2026.

Recorrência programada: nas transações seguintes, os campos IssuerTransactionId e TransactionLinkId são enviados automaticamente.

O TransactionLinkId enviado no request deve ter exatamente 22 caracteres (A-Z, a-z, 0-9, hífen e sublinhado). Se o valor estiver fora desse formato, a Cielo o ignora, sem retornar erro. Quando a Cielo envia o TLID à bandeira, a resposta traz também o SentTransactionLinkId, com o valor enviado. O request do VerifyCard não aceita o campo.

Saiba mais em Identificadores da bandeira para adquirente Cielo.

Requisição

Use o endpoint a seguir para consultar uma transação pelo PaymentId. A tabela mostra as URLs dos ambientes Sandbox e Produção.

Ambiente	Método	Endpoint
Sandbox	get	`https://apiquerysandbox.braspag.com.br/v2/sales/{PaymentId}`
Produção	get	`https://apiquery.braspag.com.br/v2/sales/{PaymentId}`

--request GET "https://apiquerysandbox.braspag.com.br/v2/sales/{PaymentId}"
--header "Content-Type: application/json"
--header "MerchantId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--header "MerchantKey: 0123456789012345678901234567890123456789"
--header "RequestId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--data-binary
--verbose

A seguir, veja as propriedades de campo nesta requisição:

Propriedade (header)	Tipo	Tamanho	Obrigatório	Descrição
`MerchantId`	Guid	36	Sim	Identificador da loja no Split de Pagamento
`MerchantKey`	Texto	40	Sim	Chave Publica para Autenticação Dupla no Split de Pagamento
`Content-Type`	Header	40	Sim	Application/json
`RequestId`	Guid	36	Não	Identificador do request definido pela loja, utilizado quando o lojista usa diferentes servidores para cada GET/POST/PUT.

Propriedade (body)	Descrição	Tipo	Tamanho	Obrigatório?
`PaymentId`	Número de identificação do pagamento.	Texto	36	Sim (envio no endpoint)

Resposta

{
   "MerchantOrderId": "2017051001",
   "Customer": {
      "Name": "Nome do Cliente",
      "Identity": "01234567789",
      "Email": "[email protected]",
      "Address": {
         "Street": "GONCALO DA CUNHA",
         "Number": "111",
         "ZipCode": "04140040",
         "City": "SAO PAULO",
         "State": "SP",
         "Country": "BRA",
         "District": "CHACARA INGLESA"
      }
   },
   "Merchant": {
      "Id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
      "TradeName": "Lojas Teste"
   },
   "Payment": {
      "ServiceTaxAmount": 0,
      "Installments": 1,
      "Interest": "ByMerchant",
      "Capture": true,
      "Authenticate": false,
      "Recurrent": false,
      "IssuerTransactionId": "580027442382078",
      "CreditCard": {
         "CardNumber": "455187******0181",
         "Holder": "Nome do Portador",
         "ExpirationDate": "12/2021",
         "Brand": "Visa"
      },
      "ProofOfSale": "2539492",
      "AcquirerTransactionId": "0510042539492",
      "AuthorizationCode": "759497",
      "Eci": "0",
      "Refunds": [
         {
            "Amount": 10000,
            "Status": 3,
            "ReceivedDate": "2017-05-15 16:25:38"
         }
      ],
      "Chargebacks": [
         {
            "Amount": 10000,
            "CaseNumber": "123456",
            "Date": "2017-06-04",
            "ReasonCode": "104",
            "ReasonMessage": "Outras Fraudes - Cartao Ausente",
            "Status": "Received",
            "RawData": "Client did not participate and did not authorize transaction"
         }
      ],
      "FraudAlert": {
         "Date": "2017-05-20",
         "ReasonMessage": "Uso Ind Numeração",
         "IncomingChargeback": false
      },
      "VelocityAnalysis": {
         "Id": "f8078b32-be17-4c35-b164-ad74c3cd0725",
         "ResultMessage": "Accept",
         "Score": 0
      },
      "PaymentId": "f8078b32-be17-4c35-b164-ad74c3cd0725",
      "Type": "CreditCard",
      "Amount": 10000,
      "ReceivedDate": "2017-05-10 16:25:38",
      "CapturedAmount": 10000,
      "CapturedDate": "2017-05-10 16:25:38",
      "VoidedAmount": 10000,
      "VoidedDate": "2017-05-15 16:25:38",
      "Currency": "BRL",
      "Country": "BRA",
      "Provider": "Simulado",
      "ProviderDescription": "Simulado",
      "ReasonCode": 0,
      "Status": 1,
      "Links": [
         {
            "Method": "GET",
            "Rel": "self",
            "Href": "https://apiquerysandbox.braspag.com.br/v2/sales/f8078b32-be17-4c35-b164-ad74c3cd0725"
         },
         {
            "Method": "PUT",
            "Rel": "capture",
            "Href": "https://apisandbox.braspag.com.br/v2/sales/f8078b32-be17-4c35-b164-ad74c3cd0725/capture"
         },
         {
            "Method": "PUT",
            "Rel": "void",
            "Href": "https://apisandbox.braspag.com.br/v2/sales/f8078b32-be17-4c35-b164-ad74c3cd0725/void"
         }
      ]
   }
}

{  
    "MerchantOrderId": "202411130002",  
    "AcquirerOrderId": "********************************",  
    "Customer": {  
        "Name": "Aline de Souza",  
        "Identity": "11122233344",  
        "Address": {}  
    },  
    "Payment": {  
        "Installments": 1,  
        "PaymentId": "69ffe23b-c3f3-4d60-90ac-46f57d32cadb",
        "EndToEndId": "E010...",  
        "Type": "Pix",  
        "Amount": 457,  
        "ReceivedDate": "2025-12-02 11:15:39",  
        "Currency": "BRL",  
        "Country": "BRA",  
        "Status": 2,  
        "Links": [  
            {  
                "Method": "GET",  
                "Rel": "self",  
                "Href": "https://apiquerysandbox.cieloecommerce.cielo.com.br/1/sales/660589f1-1076-4c8e-80fd-b001942f8915"  
            } 
        ]  
    }  
}

Propriedade	Descrição	Tipo	Tamanho	Formato
`MerchantOrderId`	Número de identificação do pedido.	Texto	50	Texto alfanumérico
`Customer.Name`	Nome do comprador.	Texto	255	Texto alfanumérico
`Customer.Identity`	Número do CPF ou CNPJ do cliente. Permite envio de CNPJs alfanuméricos.	string	14	Texto alfanumérico
`Customer.IdentityType`	Tipo de documento de identificação do comprador (CPF ou CNPJ).	Texto	255	CPF ou CNPJ
`Customer.Email`	Email do comprador.	Texto	255	Texto alfanumérico
`Customer.Birthdate`	Data de nascimento do comprador.	Date	10	formato AAAA-MM-DD
`Customer.Address.Street`	Endereço de contato do comprador.	Texto	255	Texto alfanumérico
`Customer.Address.Number`	Número do endereço de contato do comprador.	Texto	15	Texto alfanumérico
`Customer.Address.Complement`	Complemento do endereço de contato do comprador.	Texto	50	Texto alfanumérico
`Customer.Address.ZipCode`	CEP do endereço de contato do comprador.	Texto	9	Texto alfanumérico
`Customer.Address.City`	Cidade do endereço de contato do comprador.	Texto	50	Texto alfanumérico
`Customer.Address.State`	Estado do endereço de contato do comprador.	Texto	2	Texto alfanumérico
`Customer.Address.Country`	Pais do endereço de contato do comprador	Texto	35	Texto alfanumérico
`Customer.Address.District`	Bairro do endereço de contato do comprador.	Texto	50	Texto alfanumérico
`Customer.DeliveryAddress.Street`	Endereço de entrega do pedido.	Texto	255	Texto alfanumérico
`Customer.DeliveryAddress.Number`	Número do endereço de entrega do pedido.	Texto	15	Texto alfanumérico
`Customer.DeliveryAddress.Complement`	Complemento do endereço de entrega do pedido.	Texto	50	Texto alfanumérico
`Customer.DeliveryAddress.ZipCode`	CEP do endereço de entrega do pedido.	Texto	9	Texto alfanumérico
`Customer.DeliveryAddress.City`	Cidade do endereço de entrega do pedido.	Texto	50	Texto alfanumérico
`Customer.DeliveryAddress.State`	Estado do endereço de entrega do pedido.	Texto	2	Texto alfanumérico
`Customer.DeliveryAddress.Country`	País do endereço de entrega do pedido.	Texto	35	Texto alfanumérico
`Customer.DeliveryAddress.District`	Bairro do endereço de entrega do pedido.	Texto	50	Texto alfanumérico
`Merchant.Id`	Identificador da loja que efetuou essa transação.	GUID	36	xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
`Merchant.TradeName`	Nome da loja.	Texto	50	Texto alfanumérico
`Payment.Provider`	Nome do provedor do meio de pagamento.	Texto	15	Texto alfanumérico
`Payment.Type`	Tipo do meio de pagamento.	Texto	100	Ex.: "CreditCard"
`Payment.Amount`	Valor do pedido, em centavos.	Número	15	10000
`Payment.ServiceTaxAmount`	Montante do valor da autorização que deve ser destinado à taxa de serviço. Obs.: Esse valor não é adicionado ao valor da autorização.	Número	15	10000
`Payment.Currency`	Moeda na qual o pagamento será feito.	Texto	3	BRL / USD / MXN / COP / CLP / ARS / PEN / EUR / PYN / UYU / VEB / VEF / GBP
`Payment.Country`	País na qual o pagamento será feito.	Texto	3	BRA
`Payment.Installments`	Número de parcelas.	Número	2	6
`Payment.Interest`	Tipo de parcelamento.	Texto	10	Loja ("ByMerchant") ou Emissor ("ByIssuer")
`Payment.Capture`	Indica se a autorização deve ser com captura automática ou não. Deverá verificar junto à adquirente a disponibilidade desta funcionalidade.	Booleano		true / false (default)
`Payment.Authenticate`	Indica se a transação deve ser autenticada ou não. Deverá verificar junto à adquirente a disponibilidade desta funcionalidade. `Authenticate` deve ser "false" quando `Recurrent` é "true".	Booleano		true / false (default)
`Payment.Recurrent`	Indica se a transação é do tipo recorrente ou não. Obs.: Este campo igual a "true" não irá originar uma nova recorrência; apenas permitirá a realização de uma transação sem a necessidade de envio do CVV. Somente para transações Cielo. `Authenticate` deve ser "false" quando `Recurrent` é "true".	Booleano		true / false (default)
`Payment.IssuerTransactionId`	Identificador da transação gerado pela bandeira e retornado na resposta da transação CIT. Armazene o valor para enviá-lo nas transações MIT seguintes: o envio é obrigatório, para todas as bandeiras, em transações recorrentes, incrementais e reautorizadas. Consulte mais informações em Identificadores da bandeira para adquirente Cielo.	Texto	30	--
`Payment.TransactionLinkId`	Identificador único (TLID) gerado pela Mastercard e retornado na resposta, usado para vincular a transação CIT às transações MIT seguintes. Na Mastercard, envie o `TransactionLinkId` original junto com o `IssuerTransactionId`: os dois são obrigatórios, e o envio do `TransactionLinkId` é obrigatório a partir de 23/10/2026. Consulte mais informações em Identificadores da bandeira para adquirente Cielo. Formato: 22 caracteres alfanuméricos (A-Z, a-z), com diferenciação entre maiúsculas e minúsculas e podem incluir hífens (-) e sublinhados (_).	Texto	22	--
`Payment.SentTransactionLinkId`	TLID que o estabelecimento enviou no request e que a Cielo repassou à bandeira. O campo só aparece quando a Cielo enviou o TLID. Consulte mais informações em Identificadores da bandeira para adquirente Cielo.	Texto	22	--
`Payment.SoftDescriptor`	Texto que será impresso na fatura do portador.	Texto	13	Texto alfanumérico
`Payment.ExtraDataCollection.Name`	Nome do campo em que será gravado o dado extra.	Texto	50	Texto alfanumérico
`Payment.ExtraDataCollection.Value`	Valor do campo em que será gravado o dado extra.	Texto	1024	Texto alfanumérico
`Payment.AcquirerTransactionId`	Id da transação no provedor do meio de pagamento.	Texto	40	Texto alfanumérico
`Payment.ProofOfSale`	Número do comprovante de venda.	Texto	20	Texto alfanumérico
`Payment.AuthorizationCode`	Código de autorização.	Texto	300	Texto alfanumérico
`Payment.Refunds.Amount`	Valor solicitado no pedido de estorno, em centavos. O valor não indica que o estorno foi efetivado.	Número	15	10000
`Payment.Refunds.Status`	Situação do pedido de estorno. Para ver a descrição de cada status, consulte Lista de status do estorno.	Número	1	Falha de comunicação = 0 Estorno agendado (Pix) = 1 Estorno agendado (Cartão) = 2 Sucesso = 3 Negado = 4
`Payment.Refunds.ReceivedDate`	Data e hora em que o pedido de estorno foi recebido.	Texto	23	`AAAA-MM-DDThh:mm:ss.fff`
`Payment.Chargebacks[n].Amount`	Valor do chargeback, em centavos.	Número	15	10000
`Payment.Chargebacks[n].CaseNumber`	Número do caso relacionado ao chargeback.	Texto	16	Texto alfanumérico
`Payment.Chargebacks[n].Date`	Data do chargeback.	Date	10	AAAA-MM-DD
`Payment.Chargebacks[n].ReasonCode`	Código do motivo do chargeback. Lista de Valores - ReasonCode.	Texto	10	Texto alfanumérico
`Payment.Chargebacks[n].ReasonMessage`	Mensagem de motivo do chargeback. Lista de Valores - ReasonMessage.	Texto	512	Texto alfanumérico
`Payment.Chargebacks[n].Status`	Status do chargeback. Lista de Valores - Status.	Texto	32	Texto
`Payment.Chargebacks[n].RawData`	Dado enviado pela adquirente, podendo ser o titular do cartão ou outra mensagem.	Texto	512	Texto alfanumérico
`Payment.FraudAlert.Date`	Data do alerta de fraude.	Date	10	AAAA-MM-DD
`Payment.FraudAlert.ReasonMessage`	Mensagem de motivo do alerta de fraude.	Texto	512	Texto alfanumérico
`Payment.FraudAlert.IncomingChargeback`	Flag que identifica se a transação possui um chargeback ocorrido antes do alerta de fraude.	Booleano	5	Texto
`Payment.PaymentId`	Campo identificador do pedido.	Guid	36	xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
`Payment.ReceivedDate`	Data em que a transação foi recebida pelo Split.	Texto	19	AAAA-MM-DD HH:mm:SS
`Payment.ReasonCode`	Código de retorno da adquirência.	Texto	32	Texto alfanumérico
`Payment.ReasonMessage`	Mensagem de retorno da adquirência.	Texto	512	Texto alfanumérico
`Payment.CapturedAmount`	Valor capturado.	Número	15	10000
`Payment.CapturedDate`	Data da captura.	Texto	19	AAAA-MM-DD HH:mm:SS
`Payment.VoidedAmount`	Valor cancelado/estornado, em centavos.	Número	15	10000
`Payment.VoidedDate`	Data do cancelamento/estorno.	Texto	19	AAAA-MM-DD HH:mm:SS
`Payment.Status`	Status da transação.	Byte	2	Ex.: "1"
`Payment.Provider`	Provedor utilizado.	Texto	32	Simulado
`Payment.ProviderDescription`	Nome do adquirente que processou a transação.	Texto	512	Simulado
`CreditCard.CardNumber`	Número do cartão do comprador.	Texto	16
`CreditCard.Holder`	Nome do portador impresso no cartão. Obs.: Regras de tamanho do campo podem variar de acordo com a adquirente.	Texto	25
`CreditCard.ExpirationDate`	Data de validade impresso no cartão.	Texto	7	MM/AAAA
`CreditCard.Brand`	Bandeira do cartão de crédito. Valores aceitos: Visa, Master, Elo e Amex.	Texto	10
`CreditCard.SaveCard`	Identifica se o cartão será salvo para gerar o token (CardToken).	Booleano		true / false (default)