VOSCentral de Ajuda

Como conectar o Pix, o Asaas ou o Mercado Pago para receber pelo VOS

Em Configurações › Financeiro › Pagamentos, cada linha é um jeito de receber: o Pix direto se ativa com a sua chave Pix, e um meio de pagamento (Asaas, Mercado Pago, Pagar.me) se integra colando a chave da API. Conectado, ele aparece em Bancos e contas como Gateway e na coluna Situação como Conectado.

Passo a passo com imagens
Como abrir PagamentosVer o passo
  1. 1

    Abra Pagamentos

    No menu, clique em Configurações, Financeiro e na aba Pagamentos.

    Abra Pagamentos
Só Pix, sem provedorVer o passo
  1. 1

    Ativar o Pix direto

    Nos três pontinhos do Pix direto, clique em Ativar, informe o Tipo da chave e a Chave e clique em Salvar.

    Ativar o Pix direto
Com um meio de pagamentoVer os 2 passos
  1. 1

    Integrar

    Nos três pontinhos do provedor (ex.: Asaas), clique em Integrar. Cole a Chave da API gerada na sua conta do provedor, escolha o Ambiente Produção e clique em Integrar.

    Integrar
  2. 2

    Confira

    Em Bancos e contas, o provedor aparece como Gateway. Em Pagamentos, a Situação fica Conectado.

    Confira

O que é

O meio de pagamento é a empresa que recebe por você (Pix, cartão e boleto), como Asaas, Mercado Pago ou Pagar.me. Conectado ao VOS, ele faz as cobranças saírem com link de pagamento. Se você só usa Pix, o Pix direto dispensa intermediário.

Você também precisa saber

  • A conta é sua e de terceiro. Abrir, aprovar e as taxas são com o meio de pagamento. O VOS só usa a chave que você cola.
  • A chave é como uma senha. Cole direto no VOS e não mande para ninguém. Use a chave de produção, não a de teste.
  • Baixa sozinha. Os recebimentos entram pelo aviso automático do provedor (webhook), que o VOS configura ao integrar. Se você cadastrou o endereço à mão no provedor, use ⋯ › Aviso de pagamento.
  • Asaas pede documento do cliente. Para cobrar pelo Asaas, o cliente precisa de CPF ou CNPJ no cadastro.
  • Maquininha é outra aba. A maquininha de cartão fica na aba Maquininhas; o ⋯ › Taxas do provedor conectado leva para lá.

Seu caso é…?

Possíveis erros

  • “Cole a sua chave Pix”: Preencha o campo Chave do Pix direto.
  • “Cole a chave da API”: O campo ficou vazio ou curto. Copie a chave inteira no painel do provedor.
  • “O Asaas recusou a chave da empresa. Confira a chave e o modo (teste ou produção) em Configurações › Gateways.”: Confira se copiou a chave inteira e se o Ambiente escolhido é o da chave (produção × teste).
  • “O Stripe recusou a chave secreta. Confira se copiou a chave inteira e do ambiente certo.”: Copie de novo a chave secreta (sk_) do mesmo ambiente.
  • “Cole a chave publicável do Stripe, a que começa com pk_”: O Stripe pede as duas chaves: a secreta e a publicável (pk_).
  • “<Provedor> já está conectado”: Esse provedor já tem conexão. Para trocar a chave, Desconecte e integre de novo.
  • “Para cobrar pelo Asaas, o cliente precisa de CPF ou CNPJ no cadastro.”: Complete o CPF ou CNPJ na ficha do cliente antes de cobrar.
  • “Cadastre a chave Pix em Financeiro → Pagamentos”: Aparece ao gerar Pix sem chave cadastrada. Ative o Pix direto (ou integre um provedor).
  • “O segredo precisa de pelo menos 8 caracteres”: Em Aviso de pagamento, use o segredo inteiro que você cadastrou no provedor.