Emissão de Cartão Físico
Realize a emissão de um Cartão Físico.
Passos para Integrar
- Realizar autenticação na API
- Realizar a Emissão do cartão na API
- 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
Campo | Tipo | Descrição |
---|---|---|
version | string | Versão da API |
status | int | https status retornado |
customerId | int | Id do cliente vinculado a conta |
accountId | int | Id da conta cadastrada |
programid | int | Id do programa utilizado |
name | string (50) | Nome de identificação do cartão |
printedName | string (26) | Nome impresso no cartão |
type | string (10) | Para cartões físicos, sempre utilizar o type PLASTIC |
transactionLimit (opcional) | int | Indica o limite em reais por transação que pode ser utilizado em um cartão (valor máximo para compra) |
contaclessEnabled | boolean | TRUE indica que a aproximação está habilitado e FALSE indica que a aproximação esta desativada |
modeType | string (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
Campo | Tipo | Descrição |
---|---|---|
id | int | Id do cartão que foi criado |
last_digits | int | Últimos 4 dígitos gerados no cartão |
status | string(20) | Em que status o cartão se encontra. |
function | string(6) | Indica a modalidade do cartão |
bin | int | BIN que o cartão vai utilizar |
type | string(7) | O Type define qual o tipo de cartão vai ser emitido, PLASTIC para cartões físicos, VIRTUAL para cartões virtuais. |
expirationDate | date | Data de expiração do cartão emitido |
Para consultar os possíveis status de um cartão, acessar: COLOCAR LINK
Updated about 13 hours ago