Gestão de senha

As senhas são geradas aleatoriamente no momento da emissão e passa a ficar disponível para alteração e visualização.

Recomendamos que essas funcionalidades estejam disponíveis apenas para uso do cliente final em seus canais de front-end (APP ou Internet Banking), não disponíveis em painéis de backoffice utilizado por atendentes, e que seja feita sempre uma validação biométrica de face (seguindo padrões de exigência de liveness e outras tecnologias de prevenção à fraudes) antes de seguir com a requisição. O uso de validação de dados cadastrais para permitir que as ações de consulta e alteração sejam feitas não é uma validação forte.

Assim que o cartão for emitido e o cliente final já estiver com o mesmo ativo, é necessário apresentar a senha criada.

Passos para Integrar

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

Visualização de senha

Para visualizar a senha atrelada ao cartão, após realizar a autenticação, é necessário enviar a seguinte requisição:

cURL da chamada

curl -X 'GET' \
  'https://sandbox-apicorp.celcoin.com.br/cards/v1/accounts/{account}/customers/{customer}/card/{card}/password' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "pin": "1234"
}'

👍

Sucesso 200

{
    "version": "1.0.0",
    "status": 200,
    "body": {
      "cardId": 1353,
      "accountId": 251,
      "pin": "6035",
      "pan": "5AF99C6589985D0891DA82D8B1301C58"
    }
  }

Significado dos objetos

Alteração de senha

Para alterar a senha atrelada ao cartão, após realizar a autenticação, é necessário enviar a seguinte requisição:

cURL da chamada

curl -X 'PATCH' \
  'https://sandbox-apicorp.celcoin.com.br/cards/v1/accounts/{account}/customers/{customer}/card/{card}/changeCardPassword' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "pin": "1234"
}'

👍

Sucesso 200

{
  "version": "1.0",
  "status": 201,
  "body": {
    "message": "[1] Cartão atualizado"
  }
}

Significado dos objetos