Cancelar transação de cartão de crédito

Cancela ou estorna uma transação de cartão de crédito.

AmbienteMétodoEndpoint
Sandboxhttps://apisandbox.braspag.com.br/v2/sales/{PaymentId}/void
Produçãohttps://api.braspag.com.br/v2/sales/{PaymentId}/void

⚠️

Novo campo obrigatório para cancelamento de transações por risco de fraude

A partir de 17/04/2026, será obrigatório informar o campo Reason quando o motivo do cancelamento for risco de fraude identificado pelo estabelecimento.

Informe Reason= "HighRisk" no corpo da requisição, conforme exemplo:

{
    "Reason": "HighRisk"
}

Cancelamento total

Para cancelar totalmente uma transação, não é necessário enviar o campo Amount.

Cancelamento parcial

AmbienteMétodoEndpoint
Sandboxhttps://apisandbox.braspag.com.br/v2/sales/{PaymentId}/void?amount={Amount}
Produçãohttps://api.braspag.com.br/v2/sales/{PaymentId}/void?amount={Amount}

Para cancelar parcialmente uma transação, envie no campo Amount o valor em centavos que deseja cancelar.


⚠️

Não é possível estornar parcialmente uma transação não capturada.

Para fazer um cancelamento parcial, o campo Capture deve ser "true" na criação do pagamento com cartão de crédito.


A API permite cancelar transações individualmente.

Para cancelar um grupo de transações, utilize o portal e-commerce. Saiba mais em:



Path Params
string
required

Campo identificador do pedido. Tamanho: 36.

Query Params
int32

Valor, em centavos, a ser cancelado/estornado. Observações.: 1. Verifique se a adquirente contratada suporta a operação de cancelamento ou estorno. 2. Caso o valor de Amount seja informado como “0” (zero), ou esse parâmetro não seja enviado, será considerado um estorno total do valor capturado. Tamanho: 15.

Body Params
string

Indica que a transação foi cancelada por risco de fraude identificado pelo estabelecimento. Valor possível: "HighRisk". Tamanho: 8.
Obrigatório caso a transação seja cancelada porque há risco de fraude.
Válido para cancelamento total ou parcial.
ATENÇÃO: Este parâmetro estará funcional a partir de 17/04/2026.

Headers
string
required
Defaults to e3c24810-18bb-4bd7-88a0-a36d6b4a0731

Identificador da loja no Gateway de Pagamento. Tamanho: 36. Formato: GUID.
Esta documentação traz um MerchantId padrão para permitir os testes em sandbox, mas você também pode informar o MerchantId habilitado durante o processo de implantação.

string
required
Defaults to GQUAIWVDKUINZRHDQPLHUVHAIIFEIXFEXWPOYGHY

Chave pública para autenticação dupla no Gateway de Pagamento. Tamanho: 40. Formato: GUID.
Esta documentação traz um MerchantKey padrão para permitir os testes em sandbox, mas você também pode informar o MerchantKey habilitado durante o processo de implantação.

string

Identificador do request definido pela loja, utilizado quando o lojista usa diferentes servidores para cada GET/POST/PUT. Tamanho: 36.

Response

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json