Emissão de Cartão Físico

Realize a emissão de um Cartão Físico.


Passos para Integrar

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

Para cartões físicos, vai ser iniciado o processo de embossing de forma automática.

  • Embossing do Cartão Emitido.

Caso seja necessário, a consulta do status da emissão pode ser realizado manualmente.

  • Consultar status da Emissão



Emissão de Cartão Físico

Para realizar a emissão de um cartão físico, após a autenticação, é necessário realizar a seguinte requisição no endpoint api/card.

cURL da chamada

{
  "name": "Cartao prepago John",
  "printedName": "ohne Doe",
  "type": "PLASTIC",
  "transactionLimit": 100000,
  "customerId": 1,
  "accountId": 2,
  "programId": 1234,
  "contactlessEnabled": true,
  "modeType": "SINGLE"
}

👍

Sucesso 200

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

Significado dos objetos

CampoTipoDescrição
versionstringVersão da API
statusinthttps status retornado
customerIdintId do cliente vinculado a conta
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)Para cartões físicos, sempre utilizar o type PLASTIC
transactionLimit (opcional)intIndica o limite em reais por transação que pode ser utilizado em um cartão (valor máximo para compra)
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 ou COMBO para cartões com mais de uma funcionalidade no mesmo plástico

Processo de Embossing

Embossing é o processo que envolve desde o envio para uma fábrica homologada confeccionar um cartão físico até o direcionamento logístico.

🚧

Atenção!

O campo type define se o cartão a ser emitido será físico ou virtual. Utilize PLASTIC para cartões físicos que serão embossados e VIRTUAL para cartões virtuais. Assim que a requisição for enviada com o valor PLASTIC, o processo de embossing e logística são gerados.


Consulta da Emissão

Em casos de intermitência, demora do webhook ou qualquer resposta inesperada retornada pelo endpoint api/card, é possível realizar uma consulta da emissão para verificar o status da mesma.

cURL da chamada

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

👍

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

Para consultar os possíveis status de um cartão, acessar: COLOCAR LINK