Emissão de Cartão Físico

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.

Um cartão físico pode ter uma única modalidade (Pré-pago ou Pós-pago) ou mais de uma modalidade (Pré-pago e Pós-pago) em um mesmo plástico, sendo essa última modalidade também chamada de Cartão Combo.

No caso de um Cartão Combo, há dois números dentro de um mesmo cartão, sendo um escolhido como principal para o Embossing, o qual pode estar ou não impresso no cartão dependendo do layout escolhido e aprovado.

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 Físico

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