VorkPay Docs
Bem-vindo à documentação do VorkPay — o gateway de pagamentos mais simples para aceitar MB WAY e Multibanco em Portugal.
O que é o VorkPay?
O VorkPay é uma camada de abstracção sobre a infraestrutura bancária portuguesa de pagamentos. Em vez de integrares directamente com APIs complicadas e processos de onboarding longos, criamos uma API simples (estilo Stripe) com webhooks, dashboard e gestão de comissões.
Como funciona
- Cria uma conta e aguarda aprovação (até 24h).
- Obtém as tuas API Keys no dashboard.
- Inicia uma transacção via
POST /api/v1/payments/init. - Cobra o cliente com MB WAY (notificação push) ou Multibanco (referência).
- Recebe um webhook quando o pagamento é confirmado pelo banco.
Próximos passos
Quickstart
Faz o teu primeiro pagamento em 5 minutos.
Abrir
MB WAY
Aceita pagamentos instantâneos por telemóvel.
Abrir
Multibanco
Gera referências MB com entidade + referência.
Abrir
Webhooks
Recebe eventos em tempo real, com HMAC.
Abrir
Ambientes
Actualmente o VorkPay opera apenas em produção. Cada conta tem uma chave secreta (vps_live_…) usada em todas as chamadas via header Authorization: Bearer vps_live_….
Limites
- Valor mínimo por transacção: 1,00 €
- Valor máximo por transacção: 5.000,00 € (limite da rede)
- Validade da referência Multibanco: 3 dias
- Tempo de resposta MB WAY: 4 minutos
- Rate limit da API: 30 req/min por IP
Suporte
Email: suporte@vorkpay.com
