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
- Realizar autenticação na API.
- Realizar a Emissão da 2ª via do cartão na API.
- 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
| Campo | Tipo | Descrição |
|---|---|---|
| reasonId | int | Motivo da remissão do cartão |
| version | string (10) | Versão da API |
| status | int | https status retornado |
| customerId | int | Id do cliente cadastrado na Celcoin |
| 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) | PLASTIC indica que é um cartão físico e VIRTUAL indica que é um cartão virtual |
| cvvRotationItevalHours | int | Intervalo para troca do código CVV em cartões virtuais. |
| transactionLimit | int | Indica o limite que pode ser utilizado em um cartão virtual por transação |
| 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. |
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
| 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. |
Updated 2 days ago