Voxuy

Envie Pix gerado, aprovação, recusa, reembolso e chargeback pra Voxuy e dispare suas automações.

Equipe PearfyAtualizado em 28/09/2026 2 min de leitura
Onde ficaAppsVoxuy

A Voxuy recebe cada etapa das suas vendas na Pearfy: Pix ou boleto gerado, compra aprovada, recusa, reembolso e chargeback. Com isso, as automações que você montou lá podem disparar em cada etapa.

Passo a passo

  1. Na Voxuy, abra Integrações e escolha API Voxuy
  2. Copie a URL para Webhook e o Token API. Se o token estiver vazio, clique em Novo Token
  3. Em Produtos, abra o produto e clique em Adicionar plano. Dê um nome e salve
  4. Nos três pontinhos do plano, clique em Copiar código do plano. Esse código é o planId
  5. Na Pearfy, abra Apps > Voxuy e clique em Nova integração
  6. Em Nome, dê um nome que você reconheça, como "Conta principal"
  7. Em Produto, escolha um produto ou deixe Todos os produtos
  8. Cole a URL em URL do webhook, o Token API em apiToken e o código do plano em planId
  9. Clique em Conectar

Deu certo quando a integração aparece na lista como Ativo. O passo a passo do lado da Voxuy está na central de ajuda da Voxuy.

AtençãoO Conectar confere se os três campos estão preenchidos e se a URL é da Voxuy e começa com https. O apiToken e o planId só são testados na primeira venda: se um deles estiver errado, a Voxuy recusa o envio. Por isso, faça o teste abaixo logo depois de conectar.

O que é enviado

Na PearfyNa Voxuy
Pix geradoAguardando pagamento
Boleto geradoAguardando pagamento
Compra aprovadaAprovado
Pagamento recusadoRejeitado
ReembolsoEstornado
ChargebackChargeback

Cada envio leva nome, e-mail, telefone com DDI e documento do comprador, o valor total pago, a forma de pagamento e o número do pedido.

  • Order bump vai junto com a venda principal: um envio só, com o valor total
  • Upsell é uma venda à parte, do produto do upsell. Ele só vai pra Voxuy se a integração valer pra esse produto
  • Carrinho abandonado não é enviado
NotaO código do Pix e o link do boleto não vão no envio. Monte as mensagens de recuperação sem depender deles.

Como saber se está funcionando

A tela da Voxuy na Pearfy não mostra o histórico de envios. Pra testar, gere um Pix no checkout do produto, sem pagar, e confira se a transação chegou na Voxuy como aguardando pagamento.

Se a Voxuy estiver fora do ar na hora de um envio, ele não é refeito. Os próximos eventos da mesma venda seguem normalmente.

Perguntas frequentes

Apareceu "Essa URL não parece ser do Voxuy". E agora?
A Pearfy só aceita a URL para Webhook da tela API Voxuy, completa e em https. Copie de novo o link inteiro e cole no campo.
Vendo vários produtos. Uso um planId pra cada?
Pode. Crie uma integração por produto, cada uma com o planId do plano certo. Não deixe outra em Todos os produtos ao mesmo tempo: as vendas desse produto iriam pras duas.
Quero trocar só o planId. Preciso colar tudo de novo?
Sim. Na edição, deixar os três campos vazios mantém a credencial atual. Se preencher um, preencha os três e clique em Salvar.
Pausei a integração. As vendas desse período vão depois?
Não. Pausada, nada é enviado nem guardado. Ao clicar em Reativar envio, seguem só os próximos eventos.
Este artigo foi útil?

Não resolveu por aqui?

Fala com a gente. A gente te responde rápido.

Falar com o suporte