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:
- 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.
- 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
- Realizar autenticação na API.
- Realizar a Emissão do cartão virtual na API.
- 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
Campo | Tipo | Descrição |
---|---|---|
version | string (10) | Versão da API |
status | int | https status retornado |
customerId | int | Id do cliente vinculado a conta |
accountId | int | Id da conta cadastrada |
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) | PLASTIC indica que é um cartão físico e VIRTUAL indica que é um cartão virtual |
cvvRotationItevalHours | int | Intervalo em horas para troca do código CVV em cartões virtuais. |
transactionLimit | int | Indica o limite que pode ser utilizado em um cartão virtual por transação (valor máximo por compra) |
modeType | string (10) | SINGLE indica que o cartão só pode ser utilizado para uma modalidade atrelada as configurações do programa. Para cartões virtuais, sempre informar SINGLE. |
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
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 | BIN que do cartão emitido |
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 |
Updated 2 months ago