Emissão de 2ª via de cartão

Realize a emissão de uma segunda via para um cartão que foi perdido.


Passos para Integrar

  1. Realizar autenticação na API.
  2. Realizar a Emissão da 2ª via do cartão na API.
  3. Receber o Webhook com o status da Emissão.

Caso seja necessário, é possível consultar manualmente o status da emissão.

  • Consultar status da Emissão

Emissão da 2º via do cartão

Para realizar a emissão de uma 2ª via do cartão desejado, após a autenticação, é preciso enviar a seguinte requisição no endpoint api/card/reissue.

cURL da chamada

{
  "reasonId": 1,
  "cardId": 123,
  "printedName": "Nome impresso no cartão",
  "cvvRotationIntervalHours": 24,
  "embossingGroup": "Grupo de Embossadora",
  "customerId": 1,
  "accountId": 2,
  "contactlessEnabled": true,
  "templateId": null,
  "modeType": "SINGLE"
}

👍

Sucesso 200

{
  "version": false,
  "status": 200,
  "body": {
    "reasonId": 1,
    "customerId": 67,
    "accountId": 85,
    "programId": 15,
    "name": "Cartao Pre-Pago CEL ",
    "printedName": "John Doe",
    "type": "VIRTUAL",
    "cvvRotationIntervalHours": 24,
    "transactionLimit": 99999,
    "contactlessEnabled": true,
    "modeType": "SINGLE",
  }

Significado dos objetos

CampoTipoDescrição
reasonIdintMotivo da remissão do cartão
versionstring (10)Versão da API
statusinthttps status retornado
customerIdintId do cliente cadastrado na Celcoin
accountIdintId da conta cadastrada
programidintId do programa utilizado
namestring (50)Nome de identificação do cartão
printedNamestring (26)Nome impresso no cartão
typestring (10)PLASTIC indica que é um cartão físico e VIRTUAL indica que é um cartão virtual
cvvRotationItevalHoursintIntervalo para troca do código CVV em cartões virtuais.
transactionLimitintIndica o limite que pode ser utilizado em um cartão virtual por transação
contaclessEnabledbooleanTRUE indica que a aproximação está habilitado e FALSE indica que a aproximação esta desativada
modeTypestring (10)SINGLE indica que o cartão só pode ser utilizado para uma modalidade atrelada as configurações do programa.

🚧

Atenção!

A partir do momento que a 2ºvia de um cartão é emitida, o status do primeiro cartão passa para CANCELED.


Consulta da Emissão

Em casos de intermitência, demora no recebimento do webhook ou qualquer resposta inesperada retornada pelo endpoint api/card/reissue, é possível realizar uma consulta da emissão para obter uma conclusão sobre seu status..

cURL da chamada

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

👍

Sucesso 200

{
    "version": false,
    "status": 200,
    "body": {
        "id": 1216,
        "last_digits": "0412",
        "status": "NORMAL",
        "function": "DEBIT",
        "bin": "123456",
        "type": "VIRTUAL",
        "expirationDate": "24/08/2029"
    }
}

Significado dos objetos

CampoTipoDescrição
idintId do cartão que foi criado.
last_digitsintÚltimos 4 dígitos gerados no cartão.
statusstring(20)Em que status o cartão se encontra.
functionstring(6)Indica a modalidade do cartão
binintBIN que o cartão vai utilizar.
typestring(7)O Type define qual o tipo de cartão vai ser emitido, PLASTIC para cartões físicos, VIRTUAL para cartões virtuais.
expirationDatedateData de expiração do cartão emitido.