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
- Realizar a autenticação na API.
- 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
Campo | Tipo | Descrição |
---|---|---|
version | int | Versão da API |
status | int | HTPP status retorando |
id | int | Id do cartão |
statusId | int | Indica o status do cartão |
status | string(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.
Updated about 20 hours ago