Emissão de 2ª via de cartão

Realize a emissão de uma segunda via de um cartão.


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 /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,
	}
}

Lista de motivos de reemisão - reasonId

ReasonIdTipoDescrição
1PerdaPara reemitir um cartão que foi perdido, use este código.
2RouboPara reemitir um cartão que foi roubado, use este código.
3FraudePara reemitir um cartão que foi objeto de fraude, use este código.
4ExtravioPara reemitir um cartão extraviado, use este código.
5Cartão quebrado / defeituosoPara reemitir um cartão quebrado ou com defeito, use este código.

Significado dos objetos

CampoTipoDescrição
reasonIdintMotivo da remissão do cartão
versionstring (10)Versão da API
contaclessEnabledbooleanTRUE indica que a aproximação está habilitado e FALSE indica que a aproximação esta desativada - não obrigatório
abuEnabledboolean
modeTypestring (10)SINGLE indica que o cartão só pode ser utilizado para uma modalidade atrelada as configurações do programa.
updateTokensboolean

🚧

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

CampoTipoDescrição
idintId do cartão que foi criado
lastDigitsintÚltimos 4 dígitos do cartão emitido
statusstring(20)Em que status o cartão se encontra
functionstring(6)Indica a modalidade do cartão
binintBIN do cartão
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