Ativação

Também denominado Desbloqueio Inicial, a ativação de cartões físicos é uma etapa fundamental para que seus clientes possam transacionar.

Essa etapa é exclusiva para cartões físicos, não sendo possível realizar para cartões virtuais, que já são automaticamente ativados para transações após sua emissão.


Passos para Integrar

  1. Realizar a autenticação na API.
  2. Ter um cartão emitido na Celcoin e realizar ativação.


Ativação do Cartão

Assim que o cartão for emitido e estiver nas mãos do portador, a ativação do cartão precisa ser realizada para que o cliente possa começar a utilizá-lo em transações. Após a autenticação, é necessário realizar a seguinte requisição:

cURL da chamada

curl -X 'PUT' \
  'https://kubernetes.celcoin.dev/api/card/{cardId}/activate?cardId=1' \
  -H 'accept: application/json'

👍

Sucesso 200

{
  "version": 1,
  "status": 200,
  "body": {
    "id": 1,
    "statusId": 1,
    "status": "NORMAL"
  }
}

Significado dos objetos

CampoTipoDescrição
versionintVersão da API
statusintHTPP status retorando
idintId do cartão
statusIdintIndica o status do cartão
statusstring(10)Indica o status do cartão. NORMAL já pode ser utilizado.

Importante: após a ativação, a primeira compra deve ser feita com inserção do chip. O uso do cartão na função contactless será possível após a primeira compra feita com sucesso com uso do chip.

Atenção: a ativação deve estar disponível para auto atendimento do seu cliente em um canal com validações fortes, como uso de biometria facial com liveness, e limitada ou indisponível em canais de acesso a operadores ou sem validações fortes, a fim de mitigar eventuais fraudes que possam ocorrer no processo.