VortexPay

A VortexPay processa Pix na Promisse Store. A conexão pede as duas chaves de uma credencial de API, a chave pública e a chave secreta. O webhook da VortexPay é da conta: depois de conectar, você cola o endereço da loja no painel dela.

Na VortexPay#

1. Crie a conta#

   Crie a sua conta em app.vortexpag.com e entre no painel.

2. Gere a credencial#

   No painel, abra Desenvolvedor → Credenciais e gere uma credencial de API.

3. Marque os escopos#

   A loja precisa só de dois:

   Escopo	Para quê
   pix:generate	Criar a cobrança Pix do pedido
   pix:query	Consultar se o Pix foi pago

   Não marque saque, transações nem saldo: a loja nunca move o seu dinheiro.

4. Copie as chaves#

   Copie a chave pública e a chave secreta.

No painel da loja#

Abra Pagamentos, clique em Conectar na VortexPay e preencha:

Na conexão, a plataforma confere as chaves e os dois escopos sem gerar nenhuma cobrança. Se faltar escopo ou a chave estiver errada, a conexão é recusada e o motivo aparece na tela.

Cadastre o webhook#

1. Copie a URL#

   Depois de conectar, o cartão da VortexPay em Pagamentos mostra a URL do webhook. Copie esse endereço.

2. Cole na VortexPay#

   No painel da VortexPay, abra API → Webhooks, cadastre a URL e marque o evento payment.approved.

3. Salve o segredo, se houver#

   Se a VortexPay mostrar um segredo de assinatura para esse webhook, volte em Gerenciar, preencha as duas chaves de novo e cole o segredo em Segredo do webhook.

Sem o webhook cadastrado, o pagamento ainda é confirmado pela consulta periódica, só que com mais demora.

Taxa da Promisse no próprio Pix#

Na VortexPay, a taxa da plataforma sai por split no próprio Pix, como na PromissePay, na MisticPay, na AdvinPay e na SyntraPay. Você recebe a venda já sem a taxa, e o pedido não entra em fatura. O split da VortexPay leva o valor exato da taxa, e não um percentual, então até uma taxa quebrada, como 1,5%, sai no Pix. Se a VortexPay recusar o split, a venda sai normalmente e a taxa daquele pedido vai para a fatura.

Bom saber#

• A taxa da VortexPay começa em R$ 0,80 por Pix. O valor exato é o combinado na sua conta.
• A VortexPay não faz reembolso pela API. Devolva o valor no painel da VortexPay. Marcar o pedido como reembolsado na loja não devolve o dinheiro e mantém a taxa da plataforma até a VortexPay informar a devolução.
• A confirmação do pagamento é feita por consulta à VortexPay, disparada pelo aviso dela e repetida periodicamente. O aviso sozinho nunca aprova pedido, e o mesmo aviso repetido não entrega de novo.
• Ao trocar as credenciais, cole o segredo do webhook de novo. Se desconectar e conectar outra vez, a URL do webhook muda: atualize o endereço em API → Webhooks.
• Contestação de Pix (MED) é tratada no painel da VortexPay. Se o valor for devolvido ao comprador, marque o pedido como reembolsado na loja.