Menu
Feedback
Problemas conhecidos
Cartões-presente não retornam no Checkout quando são enviados CPF e CNPJ (a busca de cartões-presente prioriza corporateDocument)
Payments
ID: 1335218
Backlog
Publicado em04/12/2025
Última atualização em04/12/2025
2 min de leitura

Este problema conhecido foi traduzido automaticamente do inglês.

Sumário

Quando um perfil de comprador inclui documentos pessoais (CPF) e corporativos (CNPJ), a Pesquisa de Cartão-Presente (/giftcards/_search) prioriza o documento corporativo (CNPJ) e ignora os cartões-presente emitidos para o documento pessoal (CPF). O sintoma visível é que os cartões-presente válidos associados ao CPF do comprador não são retornados ao Checkout, resultando em respostas do tipo "código de presente inválido" ou ListAllGiftCards vazias. Isso afeta os compradores que receberam anteriormente cartões-presente vinculados ao seu CPF e que, posteriormente, prosseguem com o checkout com o CPF e o CNPJ preenchidos em seu perfil ou no payload da solicitação.

Simulação

  • Pré-requisitos:
    • Conta com o provedor de cartão-presente da VTEX (VtexGiftCard) ativa.
    • Perfil do comprador em que ambos os campos estão presentes no contexto de checkout: documento (CPF) e corporateDocument (CNPJ).

Um cartão-presente criado/associado ao CPF do comprador (ownerId = document/CPF).

Passos:

  1. No Checkout, prossiga com o comprador que tem o CPF e o CNPJ preenchidos (isCorporate pode ser verdadeiro, mas a rota de pesquisa recebe apenas document e corporateDocument).
  2. Acione o fluxo de recuperação do cartão-presente (ListAllGiftCards ou durante a anexação do pagamento). Observe que a resposta está vazia quando ambos os documentos são enviados; se o corporateDocument for omitido, o gift card vinculado ao CPF será retornado

Workaround

Certifique-se de que apenas o documento pretendido seja enviado no contexto de pesquisa do cartão-presente:

  • Se o cartão-presente foi criado para o CPF, evite enviar corporateDocument na solicitação (ou no contexto do perfil ativo do comprador no checkout) para que a pesquisa utilize o documento (CPF).
  • Como alternativa, reemita/registre um cartão-presente espelho com o mesmo saldo, mas associado ao CNPJ (corporateDocument) para esse cliente, para que a pesquisa que retorna corporateDocument o encontre.
Contribuidores
1
Photo of the contributor
+ 1 contributors
Isso foi útil?
Sim
Não
Sugerir edições (GitHub)
Contribuidores
1
Photo of the contributor
+ 1 contributors
Nesta página
Ainda tem dúvidas?
Pergunte à comunidade
Encontre soluções e compartilhe ideias na VTEX Community
Junte-se à nossa comunidade
Solicite suporte à VTEX
Receba assistência personalizada com nossos especialistas
Abra um ticket de suporte
GitHubDeveloper PortalComunidadeFeedback