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
- Realizar autenticação na API
- Realizar a Emissão do cartão na API
- 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
Campo | Tipo | Descrição |
---|---|---|
version | string | Versão da API |
status | int | https status retornado |
programid | int | Id do programa utilizado |
name | string (50) | Nome de identificação do cartão |
printedName | string (26) | Nome impresso no cartão |
type | string (10) | Para cartões físicos, sempre utilizar o type PLASTIC |
transactionLimit (opcional) | int | Indica o limite em reais por transação que pode ser utilizado em um cartão (valor máximo para compra) |
contaclessEnabled | boolean | TRUE indica que a aproximação está habilitado e FALSE indica que a aproximação esta desativada |
modeType | string (10) | SINGLE indica que o cartão só pode ser utilizado para uma modalidade atrelada as configurações do programa ou COMBO para cartões com mais de uma funcionalidade no mesmo plástico |
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
Campo | Tipo | Descrição |
---|---|---|
id | int | Id do cartão que foi criado |
lastDigits | int | Últimos 4 dígitos gerados no cartão |
status | string(20) | Em que status o cartão se encontra. |
function | string(6) | Indica a modalidade do cartão |
bin | int | Indica o BIN do cartão |
type | string(7) | O Type define qual o tipo de cartão vai ser emitido, PLASTIC para cartões físicos, VIRTUAL para cartões virtuais. |
expirationDate | date | Data de expiração do cartão emitido |
Para consultar os possíveis status de um cartão, acessar: Alteração de Status
Updated 13 days ago