> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ephra.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Reprocessar pendências da conta

> Pede ao provedor a reavaliação da subconta depois que o vendedor corrigiu o cadastro ou reenviou documentos, e devolve a situação resultante. É idempotente: cria a subconta se ainda não existir, e do contrário apenas avança a que existe. Chame depois de corrigir o cadastro ou reenviar um documento, não em laço de polling — para acompanhar sem escrever nada, use `GET /v1/subaccount-status`.



## OpenAPI

````yaml /openapi.yaml post /v1/subaccount-status/resolve
openapi: 3.0.3
info:
  title: Ephra API
  description: >-
    API pública da Ephra: cobranças (PIX, cartão e boleto), transações, webhooks
    e a API do vendedor sobre catálogo, checkout, vendas, reembolsos,
    financeiro, crescimento e plataforma.


    **Limite de requisições.** 1000 requisições por minuto por IP de origem.
    Toda resposta traz `x-ratelimit-limit`, `x-ratelimit-remaining` e
    `x-ratelimit-reset` (segundos até a janela zerar); ao estourar o limite a
    resposta é `429` com `retry-after`.


    **Erros.** Toda falha responde o mesmo envelope: `{ "success": false,
    "message": "..." }`.
  version: 1.0.0
servers:
  - url: https://api.ephra.io
    description: Servidor de produção
security: []
tags:
  - name: Catálogo
    description: Produtos, ofertas, categorias e cupons — o que a empresa vende.
  - name: Checkout
    description: Checkouts, order bumps, upsells e links de pagamento.
  - name: Vendas
    description: Vendas, clientes, assinaturas e entregas já realizadas.
  - name: Reembolsos
    description: Pedidos de reembolso, contestações e o quiz de retenção.
  - name: Financeiro
    description: Saldo, saques, antecipações, taxas e extratos da empresa.
  - name: Crescimento
    description: Afiliados, coprodução, indicações, pixels e integrações de marketing.
  - name: Plataforma
    description: Conta, membros, chaves de API, webhooks e configurações gerais.
paths:
  /v1/subaccount-status/resolve:
    post:
      tags:
        - Plataforma
      summary: Reprocessar pendências da conta
      description: >-
        Pede ao provedor a reavaliação da subconta depois que o vendedor
        corrigiu o cadastro ou reenviou documentos, e devolve a situação
        resultante. É idempotente: cria a subconta se ainda não existir, e do
        contrário apenas avança a que existe. Chame depois de corrigir o
        cadastro ou reenviar um documento, não em laço de polling — para
        acompanhar sem escrever nada, use `GET /v1/subaccount-status`.
      operationId: resolveSubaccountStatus
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties: {}
              additionalProperties: false
            example: {}
      responses:
        '200':
          description: Situação da subconta após o reprocessamento.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    description: Sempre `true` em uma resposta bem-sucedida.
                  data:
                    type: object
                    properties:
                      applicable:
                        type: boolean
                        description: >-
                          `false` quando a empresa não opera por subconta; os
                          demais campos vêm neutros e nada há a resolver.
                      isNewCompany:
                        type: boolean
                        description: >-
                          `true` para a empresa cadastrada já no fluxo novo, que
                          exige um conjunto menor de documentos.
                      outcome:
                        type: string
                        enum:
                          - ok
                          - not_eligible
                          - error
                          - none
                        description: >-
                          Resultado da consulta: `none` quando ainda não existe
                          subconta, `error` quando o provedor falhou.
                      provisioningStatus:
                        type: string
                        nullable: true
                        description: >-
                          Etapa do provisionamento relatada pelo provedor, como
                          `under_review` ou `pix_key_provisioning`.
                      status:
                        type: string
                        enum:
                          - pending
                          - active
                          - inactive
                          - blocked
                        nullable: true
                        description: Situação da subconta. Só `active` libera saque.
                      onboardingUrl:
                        type: string
                        nullable: true
                        description: >-
                          Link para concluir o cadastro no provedor, quando há
                          algo a preencher lá.
                      needsCompanyDocuments:
                        type: boolean
                        description: >-
                          `true` quando falta o documento da empresa (cartão
                          CNPJ) e a aprovação não avança sem ele.
                      hasCompanyConstitution:
                        type: boolean
                        description: >-
                          `true` quando o contrato social já está guardado e não
                          precisa ser enviado de novo.
                    required:
                      - applicable
                      - isNewCompany
                      - outcome
                      - provisioningStatus
                      - status
                      - onboardingUrl
                      - needsCompanyDocuments
                      - hasCompanyConstitution
                    additionalProperties: false
                required:
                  - success
                  - data
                additionalProperties: false
                description: Situação da subconta após o reprocessamento.
              example:
                success: true
                data:
                  applicable: true
                  isNewCompany: true
                  outcome: ok
                  provisioningStatus: under_review
                  status: active
                  onboardingUrl: https://onboarding.provedor.com.br/kyc/9f2c41ab
                  needsCompanyDocuments: false
                  hasCompanyConstitution: true
        '401':
          description: Token ausente, inválido, expirado ou de empresa bloqueada.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    description: Sempre `false` em uma resposta de erro.
                  message:
                    type: string
                    description: Mensagem legível explicando a falha.
                required:
                  - success
                  - message
                additionalProperties: false
                description: Token ausente, inválido, expirado ou de empresa bloqueada.
              example:
                success: false
                message: Token inválido ou expirado
        '422':
          description: A requisição não passou na validação de schema.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    description: Sempre `false` em uma resposta de erro.
                  message:
                    type: string
                    description: Mensagem legível explicando a falha.
                required:
                  - success
                  - message
                additionalProperties: false
                description: A requisição não passou na validação de schema.
              example:
                success: false
                message: 'name: Nome é obrigatório'
        '429':
          description: >-
            Requisições demais: o limite é de 1000 requisições por minuto por IP
            de origem. Espere o número de segundos do header `retry-after` e
            repita com recuo exponencial.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    description: Sempre `false` em uma resposta de erro.
                  message:
                    type: string
                    description: Mensagem legível explicando a falha.
                required:
                  - success
                  - message
                additionalProperties: false
                description: >-
                  Requisições demais: o limite é de 1000 requisições por minuto
                  por IP de origem. Espere o número de segundos do header
                  `retry-after` e repita com recuo exponencial.
              example:
                success: false
                message: Muitas requisições. Tente novamente em breve.
          headers:
            retry-after:
              $ref: '#/components/headers/retry-after'
            x-ratelimit-limit:
              $ref: '#/components/headers/x-ratelimit-limit'
            x-ratelimit-remaining:
              $ref: '#/components/headers/x-ratelimit-remaining'
            x-ratelimit-reset:
              $ref: '#/components/headers/x-ratelimit-reset'
        '500':
          description: >-
            Falha interna ao processar a requisição. Repita; se persistir, abra
            chamado com o horário e a rota.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    description: Sempre `false` em uma resposta de erro.
                  message:
                    type: string
                    description: Mensagem legível explicando a falha.
                required:
                  - success
                  - message
                additionalProperties: false
                description: >-
                  Falha interna ao processar a requisição. Repita; se persistir,
                  abra chamado com o horário e a rota.
              example:
                success: false
                message: Erro interno do servidor
      security:
        - bearerAuth: []
components:
  headers:
    retry-after:
      description: Segundos a esperar antes de repetir a requisição.
      schema:
        type: integer
    x-ratelimit-limit:
      description: Teto de requisições na janela (1000). Presente em toda resposta.
      schema:
        type: integer
    x-ratelimit-remaining:
      description: >-
        Quantas requisições ainda cabem na janela atual. Presente em toda
        resposta.
      schema:
        type: integer
    x-ratelimit-reset:
      description: Segundos até o contador da janela zerar. Presente em toda resposta.
      schema:
        type: integer
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````