Cartão · Tokenização
Habilitar / Desabilitar Cartão
Ativa ou inativa um cartão tokenizado
Habilitar cartão
PUT /api/v1/cards/{tokenCard}/enableDesabilitar cartão
PUT /api/v1/cards/{tokenCard}/disableAlteram o status de um cartão entre ativo (ATV) e inativo (INA). A resposta abaixo
vale para as duas operações; em disable, statusCartao retorna INA.
Requer autenticação mTLS. Veja Autenticação.
Request
Parâmetros de rota
| Parâmetro | Tipo | Obrigatório | Exemplo |
|---|---|---|---|
tokenCard | string | sim | a1b2c3d4-e5f6-4789-9abc-def012345678 |
Response
200 OK
{
"codigo": "0",
"mensagem": "Cartão habilitado com sucesso",
"token": "a1b2c3d4-e5f6-4789-9abc-def012345678",
"suffix": "1111",
"bin": "411111",
"statusCartao": "ATV",
"nsua": "123456789012345",
"nita": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0u1v2w3x4y5z6a7b8c9d0e1f2",
"clientId": "CLI-000123",
"bandeiraCartao": "1"
}Campos da resposta
| Campo | Tipo | Descrição |
|---|---|---|
codigo | string | Código de resposta. Diferente de 0 significa falha |
mensagem | string | Mensagem de resposta |
token | string | Token do cartão |
suffix | string | Últimos 4 dígitos do cartão |
bin | string | BIN do cartão |
statusCartao | enum | ATV ativo, INA inativo |
nsua | string | NSU da adquirente para a operação |
nita | string | NIT da adquirente — identificador da operação |
clientId | string | Identificador do cliente/lojista |
bandeiraCartao | string | Código da bandeira do cartão |
Erros
| Status | Significado (enable / disable) |
|---|---|
404 | Cartão não encontrado para o token informado |
409 | Cartão já se encontra habilitado (enable) / desabilitado (disable) |
500 | Erro interno ao habilitar/desabilitar o cartão |