> ## Documentation Index > Fetch the complete documentation index at: https://userepass.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Habilita pagamentos por PIX (inicia o onboarding) > Inicia a habilitação de pagamentos por PIX para a organização com os dados de KYC. Se houver vaga sob o teto de liberação, o onboarding começa imediatamente (`documents_pending`); caso contrário a organização entra na fila de liberação gradual (`requested`). Requer um usuário com permissão de administrador (owner ou admin). ## OpenAPI ````yaml /openapi.json post /payment-enablement openapi: 3.1.0 info: title: Repass API description: >- API pública do Repass — plataforma de gestão de afiliados: programas, links, tracking, atribuição, conversões, comissões, payouts, fiscal (BR), reprocessamento, event store e webhooks. version: 0.1.0 servers: - url: https://api.userepass.com description: Produção security: - bearerAuth: [] - apiKeyAuth: [] tags: - name: Profile description: Perfil do usuário autenticado. - name: Guide description: >- Guia de onboarding do painel: estado de tours, telas visitadas e preferências por usuário e organização. - name: Portal description: >- Portal do afiliado: sessão por identidade de afiliado (sem org), convites e claim. - name: Programs description: 'Programas de afiliados: configuração, atribuição, hold e tiers.' - name: Commission Rules description: Regras de comissão versionadas (imutáveis) por programa. - name: Affiliates description: 'Ciclo de vida do afiliado: cadastro, aprovação, tier, saldo.' - name: Terms description: Termos do programa, versionados. - name: Materials description: >- Materiais (criativos) do programa: upload pelo gestor e download pelos afiliados. - name: Links description: Links rastreáveis e domínios de redirecionamento. - name: Coupons description: Cupons de afiliado e sync com gateway. - name: Pagamentos por PIX description: Habilitação de pagamentos por PIX (onboarding e documentos). - name: Tracking description: Endpoints públicos de redirect e registro de cliques. - name: Clicks description: Consulta de cliques e estatísticas de link. - name: Conversions description: 'Conversões: ingestão S2S, atribuição, matching, fraude e auditoria.' - name: Commissions description: Comissões calculadas, holds, aprovação, void e clawback. - name: Payouts description: Ciclos de pagamento, prévia, execução e comprovantes. - name: Invoices description: Notas fiscais (PJ), envio e validação (BR). - name: Fraud description: Fila de revisão e decisões de fraude. - name: Reprocess description: Reprocessamento com dry-run obrigatório e relatório de impacto. - name: Events description: Histórico de eventos para auditoria e consulta. - name: Notifications description: >- Notificações ao operador (falhas de sincronização, payouts e afins) — registro in-app espelhado por e-mail aos owners/admins. - name: Webhooks description: Endpoints de webhook, entregas, retries e dead-letter. - name: Ingest description: Ingestão de eventos de cobrança (S2S e gateways). - name: Settings description: Configurações por organização (políticas e integrações). - name: Billing description: 'Plano e cobrança: contadores de uso da organização para o painel.' - name: Dashboard description: >- Métricas agregadas da operação (receita, top afiliados, conversões, comissões, novos afiliados) para a home e os relatórios do gestor. - name: Health description: Liveness do serviço. paths: /payment-enablement: post: tags: - Pagamentos por PIX summary: Habilita pagamentos por PIX (inicia o onboarding) description: >- Inicia a habilitação de pagamentos por PIX para a organização com os dados de KYC. Se houver vaga sob o teto de liberação, o onboarding começa imediatamente (`documents_pending`); caso contrário a organização entra na fila de liberação gradual (`requested`). Requer um usuário com permissão de administrador (owner ou admin). operationId: requestPaymentEnablement requestBody: required: true content: application/json: schema: type: object properties: name: type: string minLength: 1 description: Razão social ou nome completo. email: type: string format: email pattern: >- ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$ description: E-mail de contato/notificações. cpfCnpj: type: string pattern: ^\d{11}$|^\d{14}$ description: CPF ou CNPJ (somente números). companyType: type: string enum: - MEI - LIMITED - INDIVIDUAL - ASSOCIATION description: Tipo de pessoa/empresa (Asaas). birthDate: description: Data de nascimento (YYYY-MM-DD), pessoa física. type: string pattern: ^\d{4}-\d{2}-\d{2}$ phone: description: Telefone fixo. type: string mobilePhone: type: string minLength: 1 description: Celular. site: description: Site. type: string format: uri incomeValueCents: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 description: Faturamento/renda mensal, em centavos (inteiro). address: type: string minLength: 1 description: Logradouro. addressNumber: type: string minLength: 1 description: Número. complement: description: Complemento. type: string province: type: string minLength: 1 description: Bairro. postalCode: type: string pattern: ^\d{8}$ description: CEP (somente números). required: - name - email - cpfCnpj - mobilePhone - incomeValueCents - address - addressNumber - province - postalCode responses: '201': description: Default Response content: application/json: schema: type: object properties: id: type: string description: Identificador da habilitação (prefixo `pmac_`). organizationId: type: string status: type: string enum: - requested - provisioning - documents_pending - under_review - approved - rejected - suspended description: >- Status interno da habilitação de pagamentos por PIX. `requested`: na fila de liberação (waitlist). `provisioning`: em criação. `documents_pending`: aguardando envio de documentos. `under_review`: em análise. `approved`: apto a transacionar. `rejected`/`suspended`: bloqueado. readiness: type: boolean description: >- `true` quando a habilitação está aprovada (apta a pagar por PIX). waitlisted: type: boolean description: '`true` quando ainda está na fila de liberação gradual.' generalStatus: anyOf: - type: string enum: - NOT_SENT - PENDING - AWAITING_APPROVAL - APPROVED - REJECTED description: Status cru de um eixo/documento no Asaas. - type: 'null' commercialInfoStatus: anyOf: - type: string enum: - NOT_SENT - PENDING - AWAITING_APPROVAL - APPROVED - REJECTED description: Status cru de um eixo/documento no Asaas. - type: 'null' bankAccountInfoStatus: anyOf: - type: string enum: - NOT_SENT - PENDING - AWAITING_APPROVAL - APPROVED - REJECTED description: Status cru de um eixo/documento no Asaas. - type: 'null' documentationStatus: anyOf: - type: string enum: - NOT_SENT - PENDING - AWAITING_APPROVAL - APPROVED - REJECTED description: Status cru de um eixo/documento no Asaas. - type: 'null' pixStatus: anyOf: - type: string enum: - NOT_SENT - PENDING - AWAITING_APPROVAL - APPROVED - REJECTED description: Status cru de um eixo/documento no Asaas. - type: 'null' statusReason: anyOf: - type: string - type: 'null' createdAt: type: string format: date-time updatedAt: type: string format: date-time required: - id - organizationId - status - readiness - waitlisted - generalStatus - commercialInfoStatus - bankAccountInfoStatus - documentationStatus - pixStatus - statusReason - createdAt - updatedAt additionalProperties: false components: securitySchemes: bearerAuth: type: http scheme: bearer description: >- Chave de API (prefixo `rstr_`) enviada como `Authorization: Bearer rstr_...`. apiKeyAuth: type: apiKey in: header name: x-api-key description: Chave de API (prefixo `rstr_`) enviada no header `x-api-key`. ````