Skip to content
Guia da Central de Ajuda · Agências e parceiros
3 min de leituraVerificado 2026-11-16

Programas de parceiros e revendedores

Conheça as vertentes Tecnologia, Solução, Referência (até 15% de comissão) e Revenda grossista.

Neste guia

Modalidades do Ecossistema de Parceiros (partner track)

O Passinstance colabora com ISVs de POS, agências digitais, consultoras de marketing e revendedores de hardware através das quatro modalidades partner track no Passinstance database (TECHNOLOGY, SOLUTION, REFERRAL, RESELLER), regidas por partner status (APPLIED | UNDER_REVIEW | ACCEPTED | INTEGRATING | VERIFIED | ACTIVE | SUSPENDED | TERMINATED | REJECTED):

Modalidade partner trackPerfil Ideal de ParceiroCapacidades Nucleares e Modelo Comercial
TECHNOLOGYPlataformas POS, bilhética, CRM, reservas e ERPCoengenharia nativa de webhooks/API, aprovisionamento sandbox e listagem pública no diretório (partner visibility: `DRAFTPRIVATEPUBLIC`).
SOLUTIONAgências digitais e consultoras retalho/hotelariaGestão de espaços multicliente, registo de oportunidades (request payload) e integração prioritária.
REFERRALConsultores, criadores e especialistas setoriaisRastreio de atribuição (SAAS_REFERRAL_COMMISSION) com até 15% de comissão recorrente por referenciação (default: 15.00, 12 meses).
RESELLERRevendedores integrados de hardware e softwareMargens de revendedor (RESELLER_MARGIN), extras white-label e ativação de hardware NFC (partner order status).
FLUXO DE ARQUITETURA
ARQUITETURA INTERATIVA
CICLO DE VIDA DE OPORTUNIDADE E COMISSÕES DE PARCEIRO
ETAPA 01
1
CANDIDATURA E ACORDO (Partner Portal API /api/v1/partners/*)
Submeter candidatura: POST/api/v1/partners/apply (request payload)
Assinar acordo: POST/api/v1/partners/:id/agreements/:agreementId/sign
ETAPA 02
2
REGISTO DE OPORTUNIDADES E ATRIBUIÇÃO DE REFERÊNCIAS
Registar oportunidade: POST/api/v1/partners/:id/deals (request payload)
Acompanhar conversões: GET/api/v1/partners/:id/referrals
ETAPA 03
3
APURAMENTO, APROVAÇÃO E PAGAMENTO (commission status)
Fatura paga inicia apuramentoACCRUED / PENDING_APPROVAL
Validação financeiraAPPROVED
Liquidação efetuadaPAID (GET/partners/:id/commissions)

Referência da API do Portal e Diretório de Parceiros

A API de Parceiros do Passinstance gere a descoberta no diretório público, integração de parceiros, registo de negócios (opportunity status), assinatura legal de acordos (agreement status) e contabilidade de comissões (commission type: PERCENTAGE | FIXED_PER_CUSTOMER | CUSTOM):

Caminho do EndpointMétodoAutenticaçãoDescrição
/api/v1/partners/directoryGETPúblicaLista parceiros verificados no diretório público com filtros por região e especialidade.
/api/v1/partners/public/:slugGETPúblicaObtém perfil público, certificações e casos de estudo de um parceiro pelo slug.
/api/v1/partners/applyPOSTPúblicaSubmete nova candidatura a parceria (request payload).
/api/v1/partners/:idGETBearerObtém detalhes autenticados do registo do parceiro.
/api/v1/partners/:id/dealsGET / POSTBearerLista ou regista oportunidades de clientes (request payload) para assegurar atribuição.
/api/v1/partners/:id/referralsGETBearerLista conversões de referenciação self-service (referral status: `PENDINGACTIVECHURNEDDISQUALIFIED`).
/api/v1/partners/:id/agreementsGETBearerLista acordos comerciais de parceiro (agreement status).
/api/v1/partners/:id/agreements/:agreementId/signPOSTBearerRegista criptograficamente a aceitação e assinatura do parceiro num acordo.
/api/v1/partners/:id/commercial-termsGETBearerDevolve taxas de comissão ativas (revenue type) e condições de pagamento.
/api/v1/partners/:id/commissionsGETBearerObtém movimentos do livro-razão de comissões (ACCRUED, PENDING_APPROVAL, APPROVED, PAID, CANCELLED).

Submeter uma Candidatura de Parceiro e Registar uma Oportunidade

Os candidatos a parceiros podem submeter o pedido programaticamente ou através de /become-a-partner via POST /api/v1/partners/apply (request payload):

JSON
{
  "name": "Nordic Retail Systems AB",
  "slug": "nordic-retail-systems",
  "partnerType": "SOLUTION",
  "websiteUrl": "https://nordicretailsystems.example.com",
  "contactName": "Astrid Lindholm",
  "contactEmail": "astrid@nordicretailsystems.example.com",
  "description": "Multi-location loyalty and POS integrations across the Nordics.",
  "commissionRatePercent": 15,
  "commissionType": "PERCENTAGE",
  "recurringPayoutMonths": 12
}

Após aprovação e assinatura do acordo (POST /api/v1/partners/:id/agreements/:agreementId/sign), os parceiros registam oportunidades comerciais via POST /api/v1/partners/:id/deals (request payload):

JSON
{
  "prospectName": "Erik Lindqvist",
  "prospectCompany": "Stockholm Roastery Group",
  "prospectDomain": "stockholmroastery.example.se",
  "prospectEmail": "erik@stockholmroastery.example.se",
  "estimatedValue": 12000.0,
  "currency": "EUR",
  "notes": "Multi-location loyalty + NFC NFC counter integration",
  "protectionDays": 90
}

Ciclo de Vida de Apuramento, Aprovação e Liquidação de Comissões

Quando um cliente referenciado ou associado a uma oportunidade paga uma fatura de subscrição, o motor de faturação regista os ganhos através das etapas auditáveis commission status:

  1. 1
    Apuramento (POST /api/v1/admin/partners/:id/commissions/accrue): Calcula a comissão devida (ACCRUED) segundo as condições commercial-terms ativas quando a fatura passa para PAID.
  2. 2
    Aprovação (POST /api/v1/admin/partners/:id/commissions/:commissionId/approve): Bloqueia o lançamento apurado (APPROVED) após terminar o período de eventual reembolso ou estorno (commission refund status: NONE | PARTIAL_REFUND | FULL_REFUND).
  3. 3
    Liquidação (POST /api/v1/admin/partners/:id/commissions/:commissionId/settle): Regista a referência da transferência de pagamento e altera o lançamento para PAID.

Importante: Para garantir proteção de atribuição em vendas empresariais ou assistidas por agência, registe sempre o potencial cliente via POST /api/v1/partners/:id/deals antes de o cliente criar o seu espaço de produção.

Explore o ecossistema em /partners ou apresente diretamente a sua candidatura em /become-a-partner.

Documentação de produto e API relacionada

Pronto para lançar o seu primeiro programa de cartões Wallet?

Crie o seu espaço de trabalho, configure o seu modelo e teste um cartão real na Apple Wallet e Google Wallet antes de escalar.