Consulte transações no Gateway de Pagamentos.
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.
O meio de pagamento Pix estará disponível em breve!
Requisição
--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
--verboseA 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,
"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 |
|---|---|---|---|---|
| Número de identificação do pedido. | Texto | 50 | Texto alfanumérico |
| Nome do comprador. | Texto | 255 | Texto alfanumérico |
| Número do RG, CPF ou CNPJ do cliente. | Texto | 14 | Texto alfanumérico |
| Tipo de documento de identificação do comprador (CPF ou CNPJ). | Texto | 255 | CPF ou CNPJ |
| Email do comprador. | Texto | 255 | Texto alfanumérico |
| Data de nascimento do comprador. | Date | 10 | formato AAAA-MM-DD |
| Endereço de contato do comprador. | Texto | 255 | Texto alfanumérico |
| Número do endereço de contato do comprador. | Texto | 15 | Texto alfanumérico |
| Complemento do endereço de contato do comprador. | Texto | 50 | Texto alfanumérico |
| CEP do endereço de contato do comprador. | Texto | 9 | Texto alfanumérico |
| Cidade do endereço de contato do comprador. | Texto | 50 | Texto alfanumérico |
| Estado do endereço de contato do comprador. | Texto | 2 | Texto alfanumérico |
| Pais do endereço de contato do comprador | Texto | 35 | Texto alfanumérico |
| Bairro do endereço de contato do comprador. | Texto | 50 | Texto alfanumérico |
| Endereço de entrega do pedido. | Texto | 255 | Texto alfanumérico |
| Número do endereço de entrega do pedido. | Texto | 15 | Texto alfanumérico |
| Complemento do endereço de entrega do pedido. | Texto | 50 | Texto alfanumérico |
| CEP do endereço de entrega do pedido. | Texto | 9 | Texto alfanumérico |
| Cidade do endereço de entrega do pedido. | Texto | 50 | Texto alfanumérico |
| Estado do endereço de entrega do pedido. | Texto | 2 | Texto alfanumérico |
| País do endereço de entrega do pedido. | Texto | 35 | Texto alfanumérico |
| Bairro do endereço de entrega do pedido. | Texto | 50 | Texto alfanumérico |
| Identificador da loja que efetuou essa transação. | GUID | 36 | xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx |
| Nome da loja. | Texto | 50 | Texto alfanumérico |
| Nome do provedor do meio de pagamento. | Texto | 15 | Texto alfanumérico |
| Tipo do meio de pagamento. | Texto | 100 | Ex.: "CreditCard" |
| Valor do pedido, em centavos. | Número | 15 | 10000 |
| 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 |
| Moeda na qual o pagamento será feito. | Texto | 3 | BRL / USD / MXN / COP / CLP / ARS / PEN / EUR / PYN / UYU / VEB / VEF / GBP |
| País na qual o pagamento será feito. | Texto | 3 | BRA |
| Número de parcelas. | Número | 2 | 6 |
| Tipo de parcelamento. | Texto | 10 | Loja ("ByMerchant") ou Emissor ("ByIssuer") |
| 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) | |
| Indica se a transação deve ser autenticada ou não. Deverá verificar junto à adquirente a disponibilidade desta funcionalidade. | Booleano | true / false (default) | |
| 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. | Booleano | true / false (default) | |
| Texto que será impresso na fatura do portador. | Texto | 13 | Texto alfanumérico |
| Nome do campo em que será gravado o dado extra. | Texto | 50 | Texto alfanumérico |
| Valor do campo em que será gravado o dado extra. | Texto | 1024 | Texto alfanumérico |
| Id da transação no provedor do meio de pagamento. | Texto | 40 | Texto alfanumérico |
| Número do comprovante de venda. | Texto | 20 | Texto alfanumérico |
| Código de autorização. | Texto | 300 | Texto alfanumérico |
| Valor reembolsado, em centavos. | Número | 15 | 10000 |
| Status do reembolso. | Número | 1 | Received = 1 |
| Data de recebimento do reembolso. | Texto | 19 | AAAA-MM-DD HH:mm:SS |
| Valor do chargeback, em centavos. | Número | 15 | 10000 |
| Número do caso relacionado ao chargeback. | Texto | 16 | Texto alfanumérico |
| Data do chargeback. | Date | 10 | AAAA-MM-DD |
| Código do motivo do chargeback. | Texto | 10 | Texto alfanumérico |
| Mensagem de motivo do chargeback. | Texto | 512 | Texto alfanumérico |
| Status do chargeback. | Texto | 32 | Texto |
| Dado enviado pela adquirente, podendo ser o titular do cartão ou outra mensagem. | Texto | 512 | Texto alfanumérico |
| Data do alerta de fraude. | Date | 10 | AAAA-MM-DD |
| Mensagem de motivo do alerta de fraude. | Texto | 512 | Texto alfanumérico |
| Flag que identifica se a transação possui um chargeback ocorrido antes do alerta de fraude. | Booleano | 5 | Texto |
| Campo identificador do pedido. | Guid | 36 | xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx |
| Data em que a transação foi recebida pelo Split. | Texto | 19 | AAAA-MM-DD HH:mm:SS |
| Código de retorno da adquirência. | Texto | 32 | Texto alfanumérico |
| Mensagem de retorno da adquirência. | Texto | 512 | Texto alfanumérico |
| Valor capturado. | Número | 15 | 10000 |
| Data da captura. | Texto | 19 | AAAA-MM-DD HH:mm:SS |
| Valor cancelado/estornado, em centavos. | Número | 15 | 10000 |
| Data do cancelamento/estorno. | Texto | 19 | AAAA-MM-DD HH:mm:SS |
| Status da transação. | Byte | 2 | Ex.: "1" |
| Provedor utilizado. | Texto | 32 | Simulado |
| Nome do adquirente que processou a transação. | Texto | 512 | Simulado |
| Número do cartão do comprador. | Texto | 16 | |
| Nome do portador impresso no cartão. Obs.: Regras de tamanho do campo podem variar de acordo com a adquirente. | Texto | 25 | |
| Data de validade impresso no cartão. | Texto | 7 | MM/AAAA |
| Bandeira do cartão. | Texto | 10 | |
| Identifica se o cartão será salvo para gerar o token (CardToken). | Booleano | true / false (default) |