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

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