Ativação e Inativação Token do cartão

Detalhes da chamada#

Recurso: /v1/cards/{card.token}
Método HTTP: PUT
Formato da requisição: JSON
Formato da resposta: JSON
Parâmetros de cabeçalho:

Parâmetro	Descrição	Formato	Obrigatório
`merchant_id`	Código da loja no Carat. Os códigos de produção e certificação serão diferentes.	< 15 AN	SIM
`merchant_key`	Chave de autenticação da loja no Carat. As chaves de produção e certificação serão diferentes.	< 80 AN	SIM
`token`	Token obtido no serviço de criação de token Saiba mais.. Caso não seja enviado `Authorization` esse campo torna obrigatório	= 66 AN	COND.
`Authorization`	Deve ser enviada a assinatura de autenticação da loja no formato `Bearer {assinatura}`. Exemplo: `Bearer JHVGytfdgauygdauiw78264284527852897hagdg`. Caso não seja enviado `token` esse campo será obrigatório	< 2000 AN	COND.
`Content-Type`	Deve ser enviado com o valor `application/json`.	= 15 AN	SIM

Fluxo#

Exemplos#

Abaixo estão alguns exemplos de chamada do serviço de ativação e inativação do token do cartão utilizando a ferramenta cURL.

Ativação do token do cartão com autenticação utilizando token#

Requisição:

Para usar este exemplo, não esquecer de definir a variável {{url}} com o valor
esitef-homologacao.softwareexpress.com.br

curl
    --request PUT "https://{{url}}/e-sitef/api/v1/cards/{card.token}"
    --header "Content-Type: application/json"
    --header "merchant_id: xxxxxxxxxxx"
    --header "merchant_key: xxxxxxxxxxx"
    --header 'token: XXXXX'
    --data-binary
    {
       "card":{
          "status":"ATV"
       }
    }
    --verbose

Ativação do token do cartão com autenticação utilizando assinatura#

curl
    --request PUT "https://{{url}}/e-sitef/api/v1/cards/{card.token}"
    --header "Content-Type: application/json"
    --header "merchant_id: xxxxxxxxxxx"
    --header "merchant_key: xxxxxxxxxxx"
    --header 'Authorization: Bearer XXXXX'
    --data-binary
    {
       "card":{
          "status":"ATV"
       }
    }
    --verbose

Resposta:

{
   "code":"0",
   "message":"OK. Transaction successful.",
   "card":{
      "token":"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx==",
      "suffix":"5555",
      "bin": "544444",
      "status": "ATV"
   },
   "store":{
      "status":"CON",
      "nsua":"18051600000560A",
      "nita":"xxxxxxxxxxxxxxxxxxx",
      "customer_id":"11122211122",
      "authorizer_id":"2"
   }
}

Códigos de resposta

Veja a referencia no Códigos da API - códigos de resposta

Inativação do token do cartão com autenticação utilizando token#