Ficheiro de integração

O ficheiro de integração personalizado é a forma mais rápida de adicionar pagamentos VorkPay ao teu projecto. As tuas credenciais já estão incluídas — descarregas e envias directamente ao agente IA.

Descarregar o ficheiro

Vai a Dashboard → Integrações e clica em "Ficheiro de integração personalizado". Tens dois ficheiros disponíveis:

  • vorkpay-integration.md — para Lovable, Claude Code, Cursor e Windsurf
  • vorkpay-setup.js — para Replit e projectos Node.js

Usar com Lovable

  1. Descarrega o vorkpay-integration.md
  2. Abre o teu projecto no Lovable
  3. Clica no ícone de anexo (clipe) ou arrasta o ficheiro para o chat do Lovable
  4. Escreve: "Implementa a integração VorkPay descrita neste ficheiro"
  5. O Lovable vai criar as edge functions, componente de checkout e verificação de webhook
  6. Após implementar, adiciona as variáveis de ambiente em Lovable → Settings → Environment Variables (os valores estão no ficheiro)
  7. Configura o URL do webhook em Dashboard → Webhook

Usar com Claude Code

  1. Descarrega o vorkpay-integration.md
  2. Abre o Claude Code no teu projecto
  3. Arrasta o ficheiro para a janela do Claude Code ou usa /add vorkpay-integration.md
  4. Escreve: "Implementa a integração VorkPay seguindo as instruções do ficheiro"
  5. O Claude Code cria todos os ficheiros necessários automaticamente
  6. Configura o URL do webhook no dashboard

Usar com Replit

  1. Descarrega o vorkpay-setup.js
  2. Faz upload do ficheiro para a raiz do teu projecto Replit
  3. Abre o Shell do Replit e corre:
    node vorkpay-setup.js
  4. O script cria automaticamente:
    • .env com as credenciais
    • lib/vorkpay.js com o cliente da API
    • routes/vorkpay-webhook.js com o handler
    • example-payment.js para testar
  5. Instala as dependências: npm install dotenv
  6. Testa a ligação: node example-payment.js
  7. Configura o URL do webhook no dashboard

Usar com Cursor ou Windsurf

  1. Descarrega o vorkpay-integration.md
  2. Adiciona o ficheiro ao teu projecto
  3. Abre o chat do agente IA (Cmd+L no Cursor)
  4. Arrasta o ficheiro para o chat
  5. Escreve: "Segue as instruções do vorkpay-integration.md para implementar os pagamentos"

Segurança

Importante

  • Nunca commites o ficheiro para o git — contém credenciais privadas
  • Nunca partilhes o ficheiro publicamente
  • O VORKPAY_SECRET_KEY e VORKPAY_WEBHOOK_SECRET são privados — apenas no backend
  • Se suspeitares que as credenciais foram expostas, regenera-as em API Keys

Configurar webhook após implementar

Após o teu projecto estar em produção, configura o URL do webhook em Dashboard → Webhook:

https://teu-site.com/api/vorkpay/webhook