Remover cartão tokenizado

POST

/api/Transacoes/ExcluirCartao

Transacoes

Funcionalidade principal

Este endpoint é utilizado para remover permanentemente um cartão de crédito que foi previamente tokenizado e armazenado em nosso cofre seguro.

A operação é identificada pelo CartaoId, o token único do cartão que se deseja excluir. Uma vez que esta chamada é executada com sucesso, o CartaoId é invalidado e não poderá mais ser utilizado para futuras transações.

Casos de uso comuns

Implementar a funcionalidade de "Remover cartão salvo" na área de perfil de um cliente.

Excluir um cartão que expirou ou que o cliente reportou como perdido/roubado.

Atender a solicitações de exclusão de dados de pagamento, em conformidade com a Lei Geral de Proteção de Dados (LGPD).

Nota importante: Após a exclusão, se o cliente desejar utilizar o mesmo cartão novamente na plataforma, ele precisará gerar um novo CartaoId utilizando a API Cadastrar cartão (tokenizado) para compras futuras.

Requisição

Authorization

Adicionar o parâmetro

Authorization

a Cabeçalhos, cujo valor é concatenar o Token após o Bearer.

Exemplo:

Authorization: Bearer ********************

Parâmetros Header

Parâmetros Bodyapplication/json

Examples

Respostas

🟢200Correto

application/json

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

cURL

RequestExemplo

curl --location '/api/Transacoes/ExcluirCartao' \
--header 'UserName;' \
--header 'RequestOrigin;' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "Data": {
        "CodigoCanal": 0,
        "CodigoCliente": 0,
        "CartaoId": "string"
    }
}'

Response Example

Response

{
    "Data": {},
    "ResultCode": 0,
    "Message": "string",
    "ValidationData": {
        "ResultCode": 0,
        "Message": "string",
        "Errors": [
            {
                "ErrorMessage": "string",
                "FieldName": "string"
            }
        ]
    }
}

Modificado em 2026-03-09 17:40:29

Página anterior

Cadastrar cartão (tokenizado) para compras futuras

Próxima página

Recuperar dados sensíveis do cartão

Remover cartão tokenizado

Funcionalidade principal#

Casos de uso comuns#

Requisição

Respostas

Funcionalidade principal

Casos de uso comuns