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 track | Perfil de Socio Ideal | Capacidades Principales y Modelo Comercial | ||
|---|---|---|---|---|
TECHNOLOGY | Plataformas TPV, venta de entradas, CRM, reservas y ERP | Coingeniería nativa de webhooks/API, aprovisionamiento de sandbox, inclusión en el directorio público (partner visibility: `DRAFT | PRIVATE | PUBLIC`). |
SOLUTION | Agencias digitales y consultoras de comercio minorista/hostelería | Gestión de espacios de trabajo multicliente, registro de oportunidades (request payload), incorporación prioritaria. | ||
REFERRAL | Consultores, creadores y asesores del sector | Seguimiento de atribución (SAAS_REFERRAL_COMMISSION) con hasta un 15 % de comisión recurrente por referido (default: 15.00, 12 meses). | ||
RESELLER | Revendedores de paquetes de hardware y software comercial | Márgenes de revendedor (RESELLER_MARGIN), complementos de marca blanca, habilitación de hardware NFC (partner order status). |
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 Endpoint | Método | Autenticación | Descripción | |||
|---|---|---|---|---|---|---|
/api/v1/partners/directory | GET | Público | Lista los socios verificados en el directorio público con filtros por región y especialidad. | |||
/api/v1/partners/public/:slug | GET | Público | Recupera el perfil público, las certificaciones y los casos de estudio para el identificador corto de un socio. | |||
/api/v1/partners/apply | POST | Público | Envía una nueva solicitud de asociación (request payload). | |||
/api/v1/partners/:id | GET | Bearer | Recupera los detalles del registro del socio autenticado. | |||
/api/v1/partners/:id/deals | GET / POST | Bearer | Lista o registra oportunidades de clientes (request payload) para asegurar la atribución. | |||
/api/v1/partners/:id/referrals | GET | Bearer | Lista las conversiones de referidos de autoservicio (referral status: `PENDING | ACTIVE | CHURNED | DISQUALIFIED`). |
/api/v1/partners/:id/agreements | GET | Bearer | Lista los acuerdos comerciales del socio (agreement status). | |||
/api/v1/partners/:id/agreements/:agreementId/sign | POST | Bearer | Registra criptográficamente la aceptación y firma del socio en un acuerdo. | |||
/api/v1/partners/:id/commercial-terms | GET | Bearer | Devuelve las tasas de comisión activas (revenue type) y las condiciones de pago. | |||
/api/v1/partners/:id/commissions | GET | Bearer | Recupera 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):
{
"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):
{
"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
Devengo (
POST /api/v1/admin/partners/:id/commissions/accrue): Calcula la participación de la comisión (ACCRUED) en función de loscommercial-termsactivos del socio cuando la factura de un cliente pasa aPAID. -
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
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 aPAID.
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/dealsantes 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.
