Emissão/Geração de Cartão

O cartão físico é o tradicional cartão de plástico, utilizado para compras presenciais e online. Nele encontraos informações impressas como nome, número do cartão, data de validade e código de segurança (CVV). A leitura pode ser feita pelo chip nas máquinas de pagamento ou por aproximação, utilizando a tecnologia contactless.

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 na API
3. Receber o Webhook com o status da Emissão

Para cartões físicos, vai ser iniciado o processo de embossing de forma automática.

• Embossing do Cartão Emitido

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

Para realizar a emissão de um cartão físico, após a autenticação, é necessário realizar a seguinte requisição no endpoint api/card, sendo obrigatório todos os campos informados abaixo:

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 fisico Regina",
    "printedName": "Regina F Pereira",
    "type": "PLASTIC",
    "abuEnabled": false
    ,"transactionLimit": 900,
    "contactlessEnabled": true,
    "modeType": "SINGLE"
    
}'

👍

Sucesso 200

{
	"version": false,
	"status": 200,
	"body": {
		"customerId": 183,
		"name": "Cartao fisico Regina",
		"printedName": "Regina F Pereira",
		"type": "PLASTIC",
		"abuEnabled": false,
		"transactionLimit": 900,
		"contactlessEnabled": true,
		"modeType": "SINGLE",
		"tenantCostCenter": 12560
	}
}

Significado dos objetos

Processo de Embossing

Embossing é o processo que envolve desde o envio para uma fábrica homologada confeccionar um cartão físico até o direcionamento logístico.

🚧

Atenção!

O campo type define se o cartão a ser emitido será físico ou virtual. Utilize PLASTIC para cartões físicos que serão embossados e VIRTUAL para cartões virtuais. Assim que a requisição for enviada com o valor PLASTIC, o processo de embossing é gerado.

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 'User-Agent: insomnia/10.0.0' \

👍

Sucesso 200

{
	"version": "1.0.0",
	"status": 200,
	"body": {
		"id": 1967,
		"firstDigits": null,
		"lastDigits": null,
		"status": "CREATED",
		"function": null,
		"bin": null,
		"type": "PLASTIC",
		"expirationDate": null
	}
}

Significado dos objetos

Para consultar os possíveis status de um cartão, acessar: Alteração de Status