Emissão de 2ª via de cartão
Realize a emissão de uma segunda via de um cartão.
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 /card/reissue, sendo todos os campos obrigatórios.
cURL da chamada
curl --request POST \
--url https://sandbox-apicorp.celcoin.com.br/cards/v1/accounts/{accountId}/customers/{customerId}/card/{cardId}/reissue \
--header 'Authorization: Bearer {TOKEN}' \
--header 'Content-Type: application/json' \
--data '{
"reasonId": 1
,"contactlessEnabled": true
,"abuEnabled": true
,"modeType": "SINGLE"
,"updateTokens": false
}'
Sucesso 200
{
"version": "1.0.0",
"status": 200,
"body": {
"reasonId": 1,
"contactlessEnabled": true,
"abuEnabled": true,
"modeType": "SINGLE",
"updateTokens": false,
}
}
Significado dos objetos
| Campo | Tipo | Descrição |
|---|---|---|
| reasonId | int | Motivo da remissão do cartão |
| version | string (10) | Versão da API |
| contaclessEnabled | boolean | TRUE indica que a aproximação está habilitado e FALSE indica que a aproximação esta desativada - não obrigatório |
| abuEnabled | boolean | |
| modeType | string (10) | SINGLE indica que o cartão só pode ser utilizado para uma modalidade atrelada as configurações do programa. |
| updateTokens | boolean |
Atenção!
A partir do momento em que a 2ª via de um cartão é emitida, o status do cartão anterior passa a ser CANCELED.
Consulta da Emissão
Em casos de intermitência, demora no recebimento do webhook ou qualquer resposta inesperada retornada pelo endpoint /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://sandbox-apicorp.celcoin.com.br/cards/v1/accounts/{accountId}/customers/{customerId}/card?cardId={cardId}' \
-H 'accept: application/json'
Sucesso 200
{
"version": false,
"status": 200,
"body": {
"id": 1216,
"lastDigits": "0412",
"status": "NORMAL",
"function": "CREDIT",
"bin": "123456",
"type": "PLASTIC",
"expirationDate": "24/08/2029"
}
}
Significado dos objetos
| Campo | Tipo | Descrição |
|---|---|---|
| id | int | Id do cartão que foi criado |
| lastDigits | int | Últimos 4 dígitos do cartão emitido |
| status | string(20) | Em que status o cartão se encontra |
| function | string(6) | Indica a modalidade do cartão |
| bin | int | BIN do cartão |
| 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 3 days ago