Skip to content
Guía del Centro de ayuda · Agencias y socios
4 min de lecturaVerificado 2026-11-16

Programas de socios y distribuidores

Explora vías Tecnología, Soluciones, Referidos (hasta 15 % de comisión) y Reventa mayorista.

En esta guía

Modalidades del Ecosistema de Socios (partner track)

Passinstance colabora con proveedores de software independientes (ISV) de puntos de venta, agencias digitales, consultoras de marketing y revendedores de hardware en las cuatro modalidades de partner track de Passinstance database (TECHNOLOGY, SOLUTION, REFERRAL, RESELLER), regidas por partner status (APPLIED | UNDER_REVIEW | ACCEPTED | INTEGRATING | VERIFIED | ACTIVE | SUSPENDED | TERMINATED | REJECTED):

Modalidad partner trackPerfil de Socio IdealCapacidades Principales y Modelo Comercial
TECHNOLOGYPlataformas TPV, venta de entradas, CRM, reservas y ERPCoingeniería nativa de webhooks/API, aprovisionamiento de sandbox, inclusión en el directorio público (partner visibility: `DRAFTPRIVATEPUBLIC`).
SOLUTIONAgencias digitales y consultoras de comercio minorista/hosteleríaGestión de espacios de trabajo multicliente, registro de oportunidades (request payload), incorporación prioritaria.
REFERRALConsultores, creadores y asesores del sectorSeguimiento de atribución (SAAS_REFERRAL_COMMISSION) con hasta un 15 % de comisión recurrente por referido (default: 15.00, 12 meses).
RESELLERRevendedores de paquetes de hardware y software comercialMárgenes de revendedor (RESELLER_MARGIN), complementos de marca blanca, habilitación de hardware NFC (partner order status).
FLUJO DE ARQUITECTURA
ARQUITECTURA INTERACTIVA
CICLO DE VIDA DE OPORTUNIDADES Y COMISIONES DE SOCIOS
ETAPA 01
1
SOLICITUD Y ACUERDO (Partner Portal API /api/v1/partners/*)
Enviar solicitud: POST/api/v1/partners/apply (request payload)
Firmar acuerdo: POST/api/v1/partners/:id/agreements/:agreementId/sign
ETAPA 02
2
REGISTRO DE OPORTUNIDADES Y ATRIBUCIÓN DE REFERIDOS
Registrar oportunidad: POST/api/v1/partners/:id/deals (request payload)
Seguir conversiones: GET/api/v1/partners/:id/referrals
ETAPA 03
3
DEVENGO, APROBACIÓN Y PAGO DE COMISIONES (commission status)
Factura pagada activa devengoACCRUED / PENDING_APPROVAL
Verificación de finanzasAPPROVED
Liquidación de pago ejecutadaPAID (GET/partners/:id/commissions)

Referencia de la API del Portal y Directorio de Socios

La API de Socios de Passinstance gestiona el descubrimiento en el directorio público, la incorporación de socios, el registro de oportunidades (opportunity status), la firma de acuerdos legales (agreement status) y la contabilidad de comisiones (commission type: PERCENTAGE | FIXED_PER_CUSTOMER | CUSTOM):

Ruta del EndpointMétodoAutenticaciónDescripción
/api/v1/partners/directoryGETPúblicoLista los socios verificados en el directorio público con filtros por región y especialidad.
/api/v1/partners/public/:slugGETPúblicoRecupera el perfil público, las certificaciones y los casos de estudio para el identificador corto de un socio.
/api/v1/partners/applyPOSTPúblicoEnvía una nueva solicitud de asociación (request payload).
/api/v1/partners/:idGETBearerRecupera los detalles del registro del socio autenticado.
/api/v1/partners/:id/dealsGET / POSTBearerLista o registra oportunidades de clientes (request payload) para asegurar la atribución.
/api/v1/partners/:id/referralsGETBearerLista las conversiones de referidos de autoservicio (referral status: `PENDINGACTIVECHURNEDDISQUALIFIED`).
/api/v1/partners/:id/agreementsGETBearerLista los acuerdos comerciales del socio (agreement status).
/api/v1/partners/:id/agreements/:agreementId/signPOSTBearerRegistra criptográficamente la aceptación y firma del socio en un acuerdo.
/api/v1/partners/:id/commercial-termsGETBearerDevuelve las tasas de comisión activas (revenue type) y las condiciones de pago.
/api/v1/partners/:id/commissionsGETBearerRecupera los asientos del libro mayor de comisiones (ACCRUED, PENDING_APPROVAL, APPROVED, PAID, CANCELLED).

Envío de una Solicitud de Socio y Registro de una Oportunidad

Los socios potenciales pueden postularse de forma programática o a través de /become-a-partner mediante 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
}

Una vez aprobados y tras firmar el acuerdo de socio (POST /api/v1/partners/:id/agreements/:agreementId/sign), los socios registran las oportunidades de clientes mediante 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 Devengo, Aprobación y Pago de Comisiones

Cuando un cliente referido o registrado mediante oportunidad paga una factura de suscripción, el motor de facturación realiza un seguimiento de las ganancias del socio a través de etapas auditables de commission status:

  1. 1
    Devengo (POST /api/v1/admin/partners/:id/commissions/accrue): Calcula la participación de la comisión (ACCRUED) en función de los commercial-terms activos del socio cuando la factura de un cliente pasa a PAID.
  2. 2
    Aprobación (POST /api/v1/admin/partners/:id/commissions/:commissionId/approve): Bloquea el asiento devengado (APPROVED) una vez superado cualquier período de reembolso o contracargo (commission refund status: NONE | PARTIAL_REFUND | FULL_REFUND).
  3. 3
    Liquidación de Pago (POST /api/v1/admin/partners/:id/commissions/:commissionId/settle): Registra la referencia de la transferencia de pago y cambia el asiento del libro mayor de comisiones a PAID.

Importante: Para garantizar la protección de la atribución en ventas empresariales o asistidas por agencias, registre siempre al cliente potencial mediante POST /api/v1/partners/:id/deals antes de que el cliente cree su espacio de trabajo de producción.

Explore el ecosistema de socios en /partners o envíe su solicitud directamente en /become-a-partner.

Documentación de producto y API relacionada

¿Listo para lanzar su primer programa de tarjetas Wallet?

Cree su espacio de trabajo, configure su plantilla y pruebe una tarjeta real en Apple Wallet y Google Wallet antes de escalar.