Requisição

Ambiente	Método	Endpoint
Sandbox	POST	`https://apisandbox.cieloecommerce.cielo.com.br/1/physicalSales/{PaymentId}/voids/`
Homologação	POST	`https://apisandbox.cieloecommerce.cielo.com.br/1/physicalSales/{PaymentId}/voids/`
Produção	POST	`https://api.cieloecommerce.cielo.com.br/1/physicalSales/{PaymentId}/voids/`

Path Parameters

Propriedade	Tipo	Tamanho	Obrigatório	Descrição
PaymentId	String uuid	—	Sim	Código do Pagamento

{
   "MerchantVoidId":"123456789123456",
   "MerchantVoidDate":"2025-01-08T18:29:15.074Z",
   "Card":{
      "InputMode":"MagStripe",
      "TrackOneData":"4227E79441BB8E79642E442685BBDF4E5C596FC5D096271882BE25C5642E8B2B76797E1E243435A2E27422FC947F993F0A8067B0957176D97E",
      "TrackTwoData":"47F44A051AB50EE62C656B0668A26242C24AA17DD977C646",
      "EncryptedCardData":{
         "EncryptionType":"Dukpt3DesCBC",
         "TrackOneDataKSN":"FFFFF99995C18C800083",
         "TrackTwoDataKSN":"FFFFF99995C18C800084",
         "InitializationVector":"0000000000000000"
      }
}

Propriedade	Tipo	Tamanho	Obrigatório	Descrição
MerchantVoidId	String	—	Sim	Número do documento gerado automaticamente pelo terminal e incrementado a cada transação realizada
MerchantVoidDate	String	—	Sim	Data do cancelamento
Card.InputMode	String	—	Sim	Enum: Typed, MagStripe, Emv, ContactlessMagStripe, ContactlessEmv
Card.TrackOneData	String	—	—	Dados da trilha 1 obtidos via comando PP_GetCard no momento da captura
Card.TrackTwoData	String	—	—	Dados da trilha 2 obtidos via comando PP_GetCard no momento da captura
Card.EncryptedCardData.EncryptionType	String	—	Sim	Tipo de encriptação: DukptDes = 1 MasterKey = 2, Dukpt3Des = 3 Dukpt3DesCBC = 4
Card.EncryptedCardData.TrackOneDataKSN	String	—	—	Identificador KSN da trilha 1 criptografada
Card.EncryptedCardData.TrackTwoDataKSN	String	—	—	Identificador KSN da trilha 2 criptografada
Card.EncryptedCardData.IsDataInTLVFormat	Booleano	—	Não	Indica se os dados criptografados estão no formato TLV
Card.EncryptedCardData.InitializationVector	String	—	Sim	Vetor de inicialização da criptografia
Card.AuthenticationMethod	String	—	Sim	Enum: NoPassword, OnlineAuthentication, OfflineAuthentication. Método de autenticação: 1 - Sem senha = “NoPassword”; 2 - Senha online = “Online Authentication”; 3 - Senha off-line = “Offline Authentication”.

Resposta

 "InputMethod":"D",
      "CpfCnpj":"73096766000195",
      "CancelValue":"8,00",
      "OriginalTransactonData":"DADOS DO PAGAMENTO ORIGINAL",
      "OriginalTransactonType":"VENDA A CREDITO",
      "OriginalTransactonNsu":"864698",
      "OriginalTransactonAuthCode":"097122",
      "OriginalTransactionDate":"08/01/25",
      "OriginalTransactionHour":"15:32",
      "OriginalTransactionValue":"8,00",
      "OriginalTransactionCardHolder":"MTIP04",
      "OriginalTransactionMode":"ONL",
      "OriginalInputMethod":"D"
   },
   "ConfirmationStatus":1,
   "Status":10,
   "PhysicalTransactionStatus":10,
   "ReasonCode":0,
   "ReasonMessage":"Successful",
   "ReturnCode":"000",
   "ReturnMessage":">CANCELAMENTO OK",
   "Links":[
      {
         "Method":"GET",
         "Rel":"self",
         "Href":"https://apiquerysandbox.cieloecommerce.cielo.com.br/1/physicalSales/2360f2fb-5b95-4be0-8060-2815eec01f6e"
      },
      {
         "Method":"GET",
         "Rel":"self",
         "Href":"https://apisandbox.cieloecommerce.cielo.com.br/1/physicalSales/2360f2fb-5b95-4be0-8060-2815eec01f6e/voids/abd3c6bb-3af9-4a02-b048-a455fc1b9f9f"
      },
      {
         "Method":"DELETE",
         "Rel":"reverse",
         "Href":"https://apisandbox.cieloecommerce.cielo.com.br/1/physicalSales/2360f2fb-5b95-4be0-8060-2815eec01f6e/voids/abd3c6bb-3af9-4a02-b048-a455fc1b9f9f"
      }
   ]
}

Propriedade	Tipo	Tamanho	Obrigatório	Descrição
VoidId	String - uuid	—	—	Identificador do cancelamento
InitializationVersion	Integer (int16)	—	—	Número de versão dos parâmetros baixados na inicialização do equipamento
PrintMessage.Position	String	—	—	Default: Top. Enum: Top, Middle, Bottom. Posição da mensagem: Top = início do comprovante; Middle = meio após valores; Bottom = final
PrintMessage.Message	String	—	—	Mensagem a ser impressa conforme a posição definida
Status	Integer (int16)	—	—	Status da transação: 0 = Não Finalizado; 1 = Autorizado; 2 = Pago; 3 = Negado; 10 = Cancelado; 13 = Abortado
CancellationStatus	Integer (int16)	—	—	Status do cancelamento: 0 = Não Finalizado; 1 = Autorizado; 2 = Negado; 3 = Confirmado; 4 = Desfeito
ReasonCode	Integer (int16)	—	—	Código de referência para análises
ReasonMessage	String	—	—	Mensagem explicativa para análise
ReturnCode	String	—	—	Código de erro/resposta da adquirência
ReturnMessage	String	—	—	Mensagem de erro/resposta da adquirência
Payment.Receipt.MerchantName	String	255	Sim	Nome da loja
Payment.Receipt.MerchantAddress	String	255	Sim	Endereço da loja
Payment.Receipt.MerchantCity	String	255	Sim	Cidade da loja
Payment.Receipt.MerchantState	String	2	Sim	Estado da loja
Payment.Receipt.MerchantCode	String	16	Sim	Código de identificação da loja
Payment.Receipt.Terminal	String	8	Sim	Identificação do terminal
Payment.Receipt.Nsu	String	6	Sim	Número da transação Cielo
Payment.Receipt.Date	String	dd/MM/yy	Sim	Data da transação
Payment.Receipt.Hour	String	HH:mm	Sim	Hora da transação
Payment.Receipt.IssuerName	String	255	Sim	Nome do emissor obtido através do campo IssuerId no objeto BinEntry.
Payment.Receipt.CardHolder	String	255	Não	Nome do titular do cartão
Payment.Receipt.CardNumber	String	19	Sim	Número do cartão
Payment.Receipt.Brand	String	255	Sim	Bandeira do cartão
Payment.Receipt.TransactionType	String	255	Sim	Tipo da transação
Payment.Receipt.AuthorizationCode	String	6	Sim	Código da autorização
Payment.Receipt.TransactionMode	String	3	Sim	Modo da transação
Payment.Receipt.InputMethod	String	1	Sim	Método de entrada
Payment.Receipt.CancelValue	—	—	—	—
Payment.Receipt.OriginalTransactonData	—	—	—	—
Payment.Receipt.OriginalTransactonType	—	—	—	—
Payment.Receipt.OriginalTransactonNsu	—	—	—	—
Payment.Receipt.OriginalTransactonAuthCode	—	—	—	—
Payment.Receipt.OriginalTransactionDate	—	—	—	—
Payment.Receipt.OriginalTransactionHour	—	—	—	—
Payment.Receipt.OrignalTransactionValue	—	—	—	—
Payment.Receipt.OrignalTransactionCardHolder	—	—	—	—
Payment.Receipt.OriginalTransactionMode	—	—	—	—
Payment.Receipt.OriginalInputMethod	—	—	—	—
Links.Method	String	—	—	Enum: POST, GET, PUT. Método HTTP da operação
Links.Rel	String	—	—	Enum: self, cancel, confirm
Links.Href	String	—	—	URL da API