Emissão de Cartão Virtual

O cartão virtual é um cartão digital gerado pelo aplicativo, destinado a transações online. Ele contém apenas o número do cartão, data de validade e código de segurança (CVV).

Um cartão virtual é gerado automaticamente assim que a conta de cartão do usuário é criada. Ele é ativado no momento da geração, ficando pronto para uso imediato, sem a necessidade de qualquer ação adicional.

Pode ser utilizado tanto como um cartão recorrente como temporária:

  1. Recorrente: O cartão permanecerá ativo até que o usuário realize o cancelamento, podendo definir o tempo de troca do CVV através de nossas APIs.
  2. Temporário: Cartão de compra única ou que permanece ativo por um tempo específico. Nesse modelo o controle e gestão para cancelamento dos cartões após a compra ou tempo determinado é de responsabilidade do cliente.

Passos para Integrar

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

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 Virtual

Para realizar a emissão de um cartão virtual, após a autenticação, é necessário enviar a seguinte requisição no endpoint api/card, informando o valor VIRTUAL no campo type.

Todos os campos abaixo são obrigatórios.

cURL da chamada

curl --request POST \
  --url https://sandbox-apicorp.celcoin.com.br/cards/v1/accounts/{accountId}/customers/{customerId}/card \
  --header 'Authorization: Bearer {TOKEN}' \
  --header 'Content-Type: application/json' \
  --header 'User-Agent: insomnia/10.0.0' \
  --data '{
    "programId": 21,
    "name": "CARTAO DO MOSES",
    "printedName": "Moses Lakin",
    "type": "VIRTUAL",
	  "cvvRotationIntervalHours": 24,
    "abuEnabled": false
    ,"transactionLimit": 900,
    "contactlessEnabled": true,
    "modeType": "SINGLE"
 }'

👍

Sucesso 200

{
	"version": "1.0.0"
	"status": 200,
	"body": {
		"customerId": 183,
		"name": "CARTAO DO MOSES",
		"printedName": "Moses Lakin",
		"type": "VIRTUAL",
		"cvvRotationIntervalHours": 24,
		"abuEnabled": false,
		"transactionLimit": 900,
		"contactlessEnabled": true,
		"modeType": "SINGLE"
	}
}

Significado dos objetos

CampoTipoDescrição
versionstring (10)Versã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)PLASTIC indica que é um cartão físico e VIRTUAL indica que é um cartão virtual
cvvRotationItevalHoursintIntervalo em horas para troca do código CVV em cartões virtuais.
transactionLimitintIndica o limite que pode ser utilizado em um cartão virtual por transação (valor máximo por compra)
modeTypestring (10)SINGLE indica que o cartão só pode ser utilizado para uma modalidade atrelada as configurações do programa. Para cartões virtuais, sempre informar SINGLE.

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 --request GET \
  --url 'https://sandbox-apicorp.celcoin.com.br/cards/v1/accounts/{accountId}/customers/{customerId}/card?cardId={cardId}' \
  --header 'Authorization: Bearer {TOKEN}' \
  --header 'Content-Type: application/json' \
  --header 'User-Agent: insomnia/10.0.0'

👍

Sucesso 200

{
	"version": "1.0.0",
	"status": 200,
	"body": {
		"id": 1973,
		"lastDigits": "5008",
		"status": "NORMAL",
		"function": "CREDIT",
		"bin": "42605400",
		"type": "VIRTUAL",
		"expirationDate": "30/06/2029"
	}
}

Significado dos objetos

CampoTipoDescrição
idintId do cartão que foi criado
lastDigitsintÚ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 do cartão emitido
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