Gestão de cartão adicional
Ativação
A ativação do cartão adicional deve ser realizada pelo endpoint de ativação de cartão, o mesmo utilizado para ativar o cartão titular. Durante a operação, será validado se o cartão titular foi ativado em algum momento, mesmo que atualmente esteja cancelado.
É importante ressaltar que o cartão adicional não poderá ser ativado se:
- o cartão titular nunca tiver sido ativado;
- o cartão titular tiver algum status de cancelamento;
- o cartão titular tiver algum status de bloqueio.
NotaPara mais informações, consulte as documentações possíveis status do cartão e página de erros.
Status
O cartão adicional possui status próprio, que pode ser consultado pelo endpoint Consulta dos próximos status e alterado pelo endpoint Alteração do status do cartão.
No entanto, quando o cartão titular assumir algum dos status listados a seguir, o mesmo status será atribuído ao cartão adicional:
- CanceledByEmitter
- CanceledByDefaultingPayment
- CardCanceledByAccount
- DeathCanceled
- LockedByPendingPayment
- RegisterFraudCanceled
- RegisterFraudLocked
- UseFraudCanceled
- UseFraudLocked
- UpdateRegisterCanceled
- UpdateRegisterLocked
Além dos status acima listados, o cartão adicional também será automaticamente impactado por qualquer cancelamento que reflita no contrato de crédito ou na conta do titular do cartão.
NotaEm casos de bloqueios com status do tipo Reversível, quando o cartão titular for desbloqueado, os cartões adicionais retornam ao status que tinham antes do bloqueio. Para mais detalhes, consulte a página de Possíveis status do cartão.
Alteração de status do cartão adicional
Caso seja feita uma tentativa de alterar o status de um cartão adicional pelo endpointAlteração do status do cartão, estando ele em um dos status acima listados, será retornado erro assim como já ocorre para o cartão titular. Para mais detalhes, consulte o código 018 na página de erros deste endpoint.
Operações não permitidas para cartão adicional
As seguintes operações não podem ser realizadas a partir de um cartão adicional. Elas estão disponíveis apenas para o cartão titular:
- Vinculação de um cartão a conta;
- Alteração da data de vencimento da fatura;
- Alteração de limite ativo.
Nesses casos, o parceiro receberá uma mensagem de erro, pois a execução não é permitida.
NotaConsulte a seção de erros da documentação dos endpoints citados acima.