Conectar contas

Em Contas conectadas → Conectar conta, escolha onde você recebe, dê um nome à conta e cole as chaves de acesso. A SuyPay testa a conexão na hora e guarda as chaves com criptografia. Elas nunca voltam para a tela. Se as mesmas chaves já estiverem conectadas a outra conta do mesmo provedor e ambiente na sua organização, a SuyPay impede o cadastro. A comparação usa uma assinatura criptográfica das chaves de autenticação; chaves diferentes da mesma conta no provedor ainda podem passar.

Cada conta conectada tem um endereço de avisos. É por ele que a conta conta à SuyPay quando o cliente paga.

Em contas cujo provedor oferece Pix Automático, informe se a sua conta tem o recurso liberado. Se não souber, deixe Ainda não sei: a SuyPay tenta usar a conta depois das confirmadas e atualiza a situação quando receber uma resposta clara. Contas marcadas como Não liberado não recebem novos Pix Automáticos. A situação não afeta Pix comum, boleto ou cartão.

Mercado Pago

1. No Mercado Pago, vá em Suas integrações → Credenciais.
2. Copie o Access Token. Para o modo de teste, use o que começa com TEST-.
3. Cole na SuyPay.

Os avisos são configurados sozinhos, então não precisa fazer mais nada.

Asaas

1. No Asaas, vá em Integrações → Chave de API e gere uma chave.
2. Cole na SuyPay.
3. Em Integrações → Webhooks, crie um webhook com o endereço de avisos da conta (fica no menu ⋯ dela) e marque os eventos de cobrança e de Pix Automático. Configure um token no webhook e informe o mesmo token na conexão SuyPay para que mudanças de elegibilidade do Pix Automático sejam aceitas.

Dica: o Asaas sempre pede o CPF ou CNPJ do cliente.

Efí Bank

1. Na Efí, vá em API → Aplicações e copie o Client ID e o Client Secret.
2. Para receber Pix, adicione também a sua chave Pix e o certificado (.p12, em API → Meus certificados).

Boleto e cartão avisam a SuyPay sozinhos. Para o Pix, cadastre o endereço de avisos no webhook da sua chave Pix, no painel da Efí.

Stripe

1. No Stripe, vá em Desenvolvedores → Chaves de API e copie a chave secreta.
2. Em Desenvolvedores → Webhooks, adicione o endereço de avisos com os eventos payment_intent.*, checkout.session.completed, checkout.session.expired, checkout.session.async_payment_succeeded, checkout.session.async_payment_failed, charge.refunded e charge.dispute.*.

Pix e boleto pelo Stripe exigem uma conta Stripe no Brasil.

Pagar.me

1. Na Pagar.me, vá em Desenvolvimento → Chaves e copie a chave secreta. Para o modo de teste, use a que começa com sk_test_.
2. Para ver o saldo, sacar, criar subcontas e dividir pagamentos, copie também o ID do recebedor principal (em Configurações → Recebedores, começa com re_, rp_ ou pp_).
3. Em Configurações → Webhooks, crie um webhook com o endereço de avisos da conta e marque charge.paid, charge.pending, charge.payment_failed, charge.refunded, charge.partial_canceled, order.canceled e recipient.updated.

A Pagar.me pede CPF ou CNPJ e e-mail do cliente; Pix também pede celular, e boleto, endereço. No cartão, o token vem do formulário de cartão da Pagar.me no seu site (token_…, gerado com a chave pública). Split e recebedores só funcionam em contas com a adquirência Pagar.me (PSP).

Appmax

1. Na Appmax, vá no menu API → Credenciais → Gerar credenciais, escolha a loja e copie o Client ID e o Client Secret. O secret aparece uma vez só.
2. Cole na SuyPay.
3. Na aba Webhooks da mesma tela, escolha a loja, cole o endereço de avisos e marque os eventos de Pedidos e Pagamentos.

Dica: a Appmax sempre pede e-mail e celular do cliente, e CPF ou CNPJ para boleto e cartão. Se faltar algum, a SuyPay pula a Appmax e usa a próxima conta.

Woovi

1. Na Woovi, vá em API/Plugins → Nova API e copie o AppID. Para o modo de teste, crie a chave em app.woovi-sandbox.com.
2. Cole na SuyPay.
3. Em API/Plugins → Novo webhook, cadastre o endereço de avisos para os eventos de cobrança, de Pix Automático e de disputa.

A Woovi recebe só Pix, mas faz Pix Automático e avisa os MED.

EvoPay

1. Na EvoPay, abra Configurações → Token e copie o token API da conta.
2. Conecte a conta em produção e confira as taxas do seu contrato. A API publicada pela EvoPay não oferece ambiente de testes.

A EvoPay recebe o endereço de avisos em cada cobrança Pix e tenta entregar cada aviso uma vez só. A SuyPay consulta a API da EvoPay antes de aceitar um aviso e confere as cobranças em aberto na conciliação, então um aviso perdido não deixa a venda para trás. A API não faz estorno nem Pix Automático: devolva pelo painel da EvoPay e a SuyPay registra a devolução.

Inter

1. No Inter Empresas, crie uma integração com permissões de cobrança Pix e baixe o certificado e a chave privada PEM. Use as credenciais e o certificado do mesmo ambiente que selecionar na SuyPay.
2. Copie o Client ID, o Client Secret e a chave Pix recebedora. Cole tudo na SuyPay, mantendo as linhas completas dos arquivos PEM. Se a integração estiver ligada a mais de uma conta corrente, informe também o número da conta.
3. Configure no Inter o webhook Pix dessa chave com o endereço de avisos da conta conectada.

O Inter usa OAuth e certificado mTLS. A SuyPay guarda as credenciais criptografadas, reutiliza o token até perto de expirar e confere os avisos na API antes de atualizar pagamentos. No modo de teste, o botão Simular pagamento paga a cobrança pelo sandbox do Inter. O Inter publica Pix Automático, mas a integração SuyPay desta conta ainda não expõe a jornada de recorrência; mantenha assinaturas em uma conta que já suporte o fluxo completo.

Wyvi Pay

1. No painel da Wyvi Pay, abra Chaves de API e crie uma chave. Use wy_test_… no modo de teste e wy_live_… no modo real (o endereço da API é o mesmo; a chave decide o ambiente). Para fazer saques, marque o escopo transferencia:criar; para subcontas, subconta:criar e subconta:ler; para responder MED, disputa:responder.
2. Cole na SuyPay.
3. Em Webhooks, crie um destino com o endereço de avisos e os eventos cobranca.*, reembolso.* e transferencia.*. Copie o segredo whsec_… (ele aparece uma vez só) e cole em Editar → Chaves.

A Wyvi Pay recebe Pix e cartão. O cartão abre a página segura da Wyvi Pay, não existe no modo de teste e não é devolvido pela API. Pix pode ser devolvido no todo ou em parte. Para receber avisos de MED e de subcontas, assine também os eventos med.* e subconta.* no webhook da Wyvi Pay.

Pagmaster

1. Na Pagmaster, abra Integrações → Keys e crie uma chave mk_live_… com as permissões read e charges (e transfers, para saques; subaccounts, para subcontas).
2. Cole na SuyPay. Se quiser receber por uma subconta, informe o UUID dela.
3. Em Integrações → Webhooks, cadastre o endereço de avisos e cole o segredo whsec_… na SuyPay.

A Pagmaster recebe Pix de R$ 2 a R$ 2.000 e cartão de R$ 5 a R$ 2.000 numa página segura. Não publica ambiente de testes nem devolução pela API, e trata MED no painel dela.

ClownPay

1. Na ClownPay, com o KYC aprovado, abra Integrações → Credenciais e copie a credencial cp_live_….
2. Cole na SuyPay.
3. Em Integrações → Webhooks, crie o webhook com o endereço de avisos, marque os eventos de pagamento, saque e MED e cole o segredo mostrado na SuyPay.

A ClownPay pede nome, CPF/CNPJ, celular e e-mail em toda cobrança. As chaves cp_test_ só consultam dados, então a conta funciona no modo real. MED aparece em Contestações e pode ser respondido pela SuyPay.

InvictusPay

1. Na InvictusPay, abra Configurações → Credenciais de API e gere uma chave (ela aparece uma vez só).
2. Cole na SuyPay.

A SuyPay manda o endereço de avisos em cada cobrança. Para acompanhar saques, cadastre o mesmo endereço em Webhooks com o evento de saque. A InvictusPay recebe Pix e boleto pela SuyPay e pede nome, e-mail, CPF/CNPJ e celular. O cartão dela exige o número do cartão na chamada, e a SuyPay nunca recebe números de cartão.

TriboPay

1. Na TriboPay, abra Configurações → API e copie o token.
2. A TriboPay só vende por uma oferta: crie um produto e uma oferta no painel e copie os hashes dos dois. O valor de cada cobrança vem da SuyPay, não do preço cadastrado.
3. Cole o token e os dois hashes na SuyPay.

A TriboPay recebe o endereço de avisos em cada cobrança. Recebe Pix e boleto (boleto pede endereço) e saca para a conta bancária cadastrada no painel dela.

RivooPay

1. Copie a chave de API no painel da RivooPay.
2. Cole na SuyPay. A mesma chave serve aos dois modos: no modo de teste a SuyPay cria as cobranças como teste (devMode) e o botão Simular pagamento confirma pela API da RivooPay.
3. Em Webhooks, cadastre o endereço de avisos com os eventos de cobrança.

A RivooPay recebe Pix a partir de R$ 5 e pede CPF/CNPJ, e-mail e celular.

O que cada conta faz

Contas que pedem mais dados

Algumas contas não aceitam a venda sem certos dados do cliente. A SuyPay sabe disso: se faltar um dado que uma conta exige, ela é pulada (aparece como "Pulada" no histórico da cobrança) e a venda vai pela próxima.

Taxas

Ao conectar, confira as taxas que você paga em cada conta. A SuyPay usa esses valores para escolher a mais barata, e a conferência diária ajusta tudo com o valor real cobrado. O formulário mostra primeiro as chaves de acesso e a opção de buscar taxas. Abra Ver ou preencher taxas manualmente quando precisar editar os valores.

Para cada forma de pagamento, informe o percentual e o valor fixo. Se o contrato cobrar pelo menos um valor ou limitar a taxa a um teto, marque Usar taxa mínima e/ou Usar taxa máxima e informe os valores. Desmarque para remover um limite. Eles são opcionais e valem para qualquer conta conectada. A SuyPay estima a taxa como percentual mais valor fixo, respeitando os limites que você informou.

No cartão, a taxa principal vale para 1x. Abra Taxas por parcela para adicionar uma taxa própria para cada quantidade aceita pela conta. Parcelas sem taxa própria usam a taxa de 1x; o mínimo e o máximo do cartão continuam valendo. A SuyPay usa a quantidade de parcelas da cobrança tanto para estimar a taxa quanto para escolher a conta. A lista vai só até o limite que cada provedor declara; contas sem cartão não mostram essa opção.

No Asaas, depois de informar a chave de API, toque em Buscar taxas da conta. O botão indica Configure primeiro enquanto faltarem chaves. A SuyPay usa a consulta autenticada do Asaas para preencher Pix, boleto, cartão à vista e as faixas de parcelamento que a API devolver. Confira antes de conectar ou salvar: franquias mensais gratuitas de Pix não entram na estimativa, e parcelas sem faixa devolvida pela API continuam usando a taxa de 1x. Se a API devolver um desconto com prazo, a tela avisa para buscar as taxas novamente depois do vencimento. O botão também aparece nos outros provedores, mas indica quando a consulta da taxa contratual da loja não está disponível; nesses casos, preencha as taxas conforme seu contrato. As rotas de parcelas da Appmax e da Efí calculam valores e juros do parcelamento, que podem ser cobrados do cliente; esses valores não devem ser confundidos com a taxa cobrada da loja. Uma transação isolada também não representa necessariamente as taxas da conta.

Em Contas conectadas, passe o mouse sobre a conta ou toque e segure para revelar a alça dentro da borda esquerda. Arraste por ela para mudar a preferência. A conta no topo vem primeiro na regra Minha preferência e serve de desempate quando duas contas têm o mesmo custo. Pelo teclado, use as setas para cima e para baixo com a alça selecionada.

Eventos do webhook

Ao editar uma conta, a SuyPay mostra o endereço de avisos. Abra Quais eventos configurar? para ver os nomes exatos dos eventos separados por função: pagamentos, estornos, contestações e Pix Automático, quando disponíveis. Toque em um nome para copiá-lo, depois marque o evento no provedor. Na Efí, boleto e cartão recebem o endereço junto com cada cobrança; para Pix, cadastre o webhook da chave Pix.

Cada grupo funciona de forma independente. Se você não configurar eventos de contestação, por exemplo, os avisos de pagamento configurados continuam chegando; a parte de contestações pode ficar sem atualização. A SuyPay também faz a conferência das cobranças, mas ela não substitui todos os tipos de aviso.

No celular, a lista de contas rola verticalmente. Toque e segure uma conta para revelar a alça; só a alça arrasta a conta, e ela permanece visível durante o movimento. Os formulários abrem como folhas com conteúdo rolável, agrupadas por tarefa, e os campos de taxa ficam em uma coluna para caber na tela. Na etapa de taxas, Buscar taxas da conta e Preencher manualmente ficam lado a lado; os valores importados podem ser conferidos antes de conectar.