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 Multiapp, há dois números dentro de um mesmo cartão, sendo o débito escolhido como principal para o Embossing, e estará impresso no cartão.

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