Erro de permissão ao tokenizar um cartão

Você vai identificar por que a tokenização de cartão foi bloqueada e quais informações enviar para solicitar a habilitação do recurso.

O que esse erro significa

Esse erro indica que a sua conta ainda não possui liberação para usar a funcionalidade de tokenização. A tokenização de cartão é o processo de substituir os dados sensíveis do cartão por um token, que pode ser usado em fluxos autorizados sem reenviar os dados originais do cartão.

Enquanto a funcionalidade não estiver habilitada para a sua conta, as tentativas de tokenizar um cartão serão bloqueadas pela regra de permissão da plataforma.

Quando esse erro ocorre

Esse erro pode ocorrer quando você tenta iniciar um fluxo de tokenização antes da habilitação da funcionalidade na sua conta. Ele não indica, por si só, que os dados do cartão estão incorretos ou que houve uma falha técnica na integração.

Antes de investigar a integração, confirme se a tokenização está liberada para a conta usada na requisição.

Como solicitar a habilitação

1. Entre em contato com um dos nossos gerentes de contas.
2. Informe que você precisa habilitar a funcionalidade de tokenização de cartão.
3. Compartilhe o contexto da integração, incluindo:
   • a conta que fará a tokenização;
   • o ambiente em que o erro ocorreu;
   • a mensagem de erro recebida;
   • o fluxo em que a tokenização será usada.
4. Aguarde a confirmação de habilitação antes de executar novas tentativas de tokenização.

Como validar após a liberação

Depois que o gerente de contas confirmar a habilitação, execute novamente o fluxo de tokenização com a mesma conta. Se a permissão estiver ativa, a requisição não deve mais retornar a mensagem “Você não possui permissão para utilizar este recurso”.

Se o erro continuar ocorrendo, confirme se a requisição está usando a conta correta e envie a mensagem de erro atualizada ao gerente de contas para nova análise.

Impacto na integração

Sem a habilitação, a sua integração não conseguirá gerar tokens de cartão. Como consequência, qualquer etapa do seu fluxo que dependa desses tokens ficará indisponível até que a permissão seja liberada.