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

# Subcontas e KYC

> Cadastre subcontas, envie os documentos para análise, acompanhe o status do credenciamento e obtenha as chaves de API de cada subconta.

Cada vendedor, lojista ou cliente que opera dentro da sua estrutura Connect precisa de uma **subconta** (SubMerchant). O ciclo tem três partes: você cadastra a empresa, envia os documentos para a análise de KYC (a verificação da identidade das pessoas e dos dados da empresa) e, quando a Finvia aprova, a subconta recebe as próprias chaves de API para vender.

> [!NOTE]
>
> **Para o negócio:** a subconta só vende depois de aprovada. Monte o formulário de cadastro da sua plataforma já com todos os campos e documentos listados nesta página. Dados faltando ou documentos ilegíveis levam a pedidos de correção (status `correcting`), e o cadastro volta para a fila de análise.

## Quando usar

* **Entrada de um novo vendedor no marketplace**: o vendedor preenche o cadastro na sua plataforma e a sua aplicação cria a subconta pela API.
* **Credenciamento de lojistas por um PSP**: cada lojista credenciado vira uma subconta com dados bancários e documentos próprios.
* **Migração de uma base de clientes** para o Connect: a criação em lote é feita chamando a rota uma vez por empresa.

Se a empresa tem mais de um sócio e você precisa enviar documentos de cada um, veja também [Sócios e documentos](https://docs.fastpaybrasil.com/guias/fast-connect/socios-e-documentos.md). Os documentos exigidos, o prazo médio da análise, os motivos de recusa e os ramos (MCCs) não aceitos estão em [Regras de credenciamento](https://docs.fastpaybrasil.com/guias/fast-connect/regras-de-credenciamento.md).

## Como funciona

A sequência abaixo mostra o credenciamento de uma subconta, do cadastro até as chaves de API.

```mermaid placement="top-right" className="finvia-diagrama" theme={null}
%%{init: {"theme": "base", "fontFamily": "Inter, sans-serif", "themeVariables": {"fontFamily": "Inter, Arial, sans-serif", "fontSize": "15px", "primaryColor": "#EAF3FF", "primaryBorderColor": "#017AFF", "primaryTextColor": "#070D15", "secondaryColor": "#F3F5F8", "tertiaryColor": "#FFFFFF", "lineColor": "#5B6B82", "textColor": "#070D15", "edgeLabelBackground": "#FFFFFF", "clusterBkg": "#F7F9FC", "clusterBorder": "#D5DCE6", "actorBkg": "#FFFFFF", "actorBorder": "#98A2B3", "actorTextColor": "#070D15", "actorLineColor": "#B8C2D1", "signalTextColor": "#070D15", "labelBoxBkgColor": "#EAF3FF", "labelBoxBorderColor": "#017AFF", "labelTextColor": "#003A7A", "loopTextColor": "#070D15", "noteBkgColor": "#FFF6E5", "noteBorderColor": "#F0B44C", "noteTextColor": "#5C3D00", "activationBkgColor": "#EAF3FF", "activationBorderColor": "#017AFF", "sequenceNumberColor": "#FFFFFF", "signalColor": "#5B6B82"}, "flowchart": {"curve": "basis", "nodeSpacing": 45, "rankSpacing": 55, "padding": 18}, "sequence": {"mirrorActors": false, "showSequenceNumbers": true, "actorMargin": 60, "messageMargin": 38, "boxMargin": 10, "noteMargin": 12, "wrap": true}}}%%
sequenceDiagram
    autonumber
    box rgb(243,245,248) Sua aplicação
        participant S as Seu servidor (master)
        participant R as URL de aviso (postbackUrl)
    end
    box rgb(234,243,255) Finvia
        participant F as Finvia API
        participant K as Análise Finvia (KYC)
    end
    Note over S: Pré-valida dados e documentos do lojista
    S->>F: POST /v1/submerchants (chave da master)
    F-->>S: 201 · id · legalRepresentatives (nasce pending)
    S->>F: POST /v1/submerchants/{id}/document (multipart)
    F-->>S: 201 sem corpo
    F->>K: Cadastro e documentos entram na análise
    alt Correção pedida
        K-)R: Aviso correcting · rejectionReason
        Note over S,K: Correção feita no painel Finvia. O cadastro volta para pending, sem aviso
    else Documentos conferidos e aprovação final
        K-)R: Aviso pre_approved
        K-)R: Aviso active
        S->>F: GET /v1/submerchants/{id}
        F-->>S: status active · approvedAt
        S->>F: GET /v1/submerchants/{id}/api-keys
        F-->>S: publicKey e secretKey
    else Reprovada
        K-)R: Aviso rejected · rejectionReason
    end
```

**1. Pré-valide o lojista**

Confira do seu lado os dados e documentos do lojista antes de enviar, como pedem as [Regras de credenciamento](https://docs.fastpaybrasil.com/guias/fast-connect/regras-de-credenciamento.md).

**2. Crie a subconta**

`POST /v1/submerchants` com a chave secreta da conta master. A resposta traz o `id` da subconta e a lista `legalRepresentatives`. A subconta começa com status `pending`.

**3. Envie os documentos**

`POST /v1/submerchants/{id}/document` em `multipart/form-data`, um arquivo por tipo de documento.

**4. Acompanhe a análise**

A Finvia analisa o cadastro. Você acompanha pelo aviso de mudança de status e pela consulta `GET /v1/submerchants/{id}`.

**5. Corrija, se pedido**

Se o status for para `correcting`, o motivo vem no aviso. Depois que a correção é reenviada, o cadastro volta para a análise.

**6. Obtenha as chaves**

Com o status `active`, busque as chaves em `GET /v1/submerchants/{id}/api-keys` e guarde no seu cofre de segredos.

## Regras de negócio

| Regra | Detalhe |
| - | - |
| Quem cria | A conta master, com a chave secreta dela |
| Cópia de taxas | Na criação, a subconta recebe uma cópia das taxas, permissões e configurações da master. Depois, as taxas são independentes |
| CNPJ único | O mesmo CNPJ não pode ser cadastrado em duas subcontas da mesma master, em qualquer status, nem repetir o CNPJ da master (`409`) |
| Representante legal | `legalRepresentative` é obrigatório e é sempre o representante legal da empresa |
| Sócios adicionais | Opcionais, em `additionalRepresentatives`, com o mesmo formato do representante legal |
| Acesso ao painel | `canAccessDashboard` é obrigatório. Se for `true`, o objeto `user` passa a ser obrigatório |
| Descrição na fatura | `softDescriptor` tem no máximo 40 caracteres |
| Documentos aceitos | JPEG, JPG, PNG, GIF, BMP, WEBP ou PDF, até 50 MB por arquivo |
| Upload após aprovação | Bloqueado. A API responde `422` |
| Correção de cadastro | Feita pelo painel, na gestão de subcontas, não pela API |
| Chaves | Obtidas pela master em `GET /v1/submerchants/{id}/api-keys`. Use-as para cobrar só com a subconta `active` |

> [!WARNING]
>
> Com país `BRA`, o `companyTaxId`, o `idNumber` do representante legal e dos sócios (CPF) e o `bankAccount.recipientDocument` são **validados com dígitos verificadores**. Os números desta página são válidos só para teste de formato. Use os documentos reais da empresa e das pessoas.

## Dados exigidos na criação

O corpo de `POST /v1/submerchants` é organizado em blocos. Todos os campos marcados como obrigatórios precisam estar presentes.

### Empresa

| Campo | Tipo | Obrigatório | Descrição |
| - | - | - | - |
| `legalName` | string | Sim | Razão social |
| `tradeName` | string | Sim | Nome fantasia |
| `companyTaxId` | string | Sim | CNPJ da empresa, com ou sem máscara. Com país `BRA`, o dígito verificador é validado |
| `website` | string (`uri`) | Sim | URL do lojista, onde estão os produtos ou serviços que serão vendidos |
| `averageMonthlyRevenue` | number | Sim | Expectativa de faturamento médio mensal, em reais |
| `averageOrderValue` | number | Sim | Ticket médio por pedido, em reais |
| `productType` | string | Sim | Tipo de produto vendido: `digital`, `physical` ou `both` |
| `contactEmail` | string | Sim | E-mail de contato da empresa |
| `productDescription` | string | Sim | Descrição curta dos produtos ou serviços |
| `softDescriptor` | string | Não | Nome que aparece na fatura do cartão do cliente. Máximo de 40 caracteres |
| `address` | object | Sim | Endereço da empresa (veja a tabela abaixo) |
| `phones` | array | Sim | Telefones da empresa. Cada item tem `type` (ex.: `mobile`) e `number`, os dois obrigatórios |
| `postbackUrl` | string (`uri`) | Não | URL para receber o aviso quando o status da subconta mudar (veja [Status que geram aviso](#status-que-geram-aviso)) |

> [!NOTE]
>
> **Para o negócio:** `website`, `averageMonthlyRevenue` e `averageOrderValue` são a URL do lojista, a expectativa de faturamento e o ticket médio que as [Regras de credenciamento](https://docs.fastpaybrasil.com/guias/fast-connect/regras-de-credenciamento.md) exigem. `productType` precisa refletir o que o vendedor realmente vende; se ele vende os dois tipos, cadastre `both`.

#### Endereço

| Campo | Obrigatório | Descrição |
| - | - | - |
| `addressLine1` | Sim | Logradouro e número, separados por vírgula, com o número no fim. Ex.: `Av. Paulista, 1000`. O número é extraído desse formato para o credenciamento nas adquirentes; sem vírgula e número, pode ir como "S/N" |
| `addressLine2` | Não | Complemento: apartamento, sala, bloco, andar. Ex.: `Sala 12` |
| `referencePoint` | Não | Ponto de referência, até 255 caracteres. Só é gravado no endereço da empresa |
| `neighborhood` | Sim | Bairro. Obrigatório quando o país é `BRA` |
| `city` | Sim | Cidade |
| `state` | Sim | Estado. Com país `BRA`, precisa ser uma UF válida (ex.: `SP`) |
| `country` | Sim | País em ISO 3166-1 alpha-3, em maiúsculas. Ex.: `BRA`. `BR` é recusado com `400` |
| `postalCode` | Sim | CEP. Com país `BRA`, 8 dígitos. Ex.: `01310100` |

### Representante legal

Objeto `legalRepresentative`, obrigatório.

| Campo | Tipo | Obrigatório | Descrição |
| - | - | - | - |
| `fullName` | string | Sim | Nome completo |
| `idNumber` | string | Sim | Número do documento. Precisa ser um CPF válido quando `issuingCountry` é `BRA` ou não é enviado |
| `idType` | string | Não | Tipo do documento de identificação (ex.: `cpf`) |
| `issuingCountry` | string | Não | País emissor do documento, em ISO 3166-1 alpha-3 (ex.: `BRA`) |
| `dateOfBirth` | string (`date`) | Sim | Data de nascimento, no formato `AAAA-MM-DD` |
| `nationality` | string | Sim | Nacionalidade, em texto livre (ex.: `Brasileira`) |
| `email` | string | Sim | E-mail |
| `motherName` | string | Sim | Nome da mãe |
| `gender` | string | Sim | `M` ou `F` |
| `phones` | array | Sim | Telefones, cada um com `type` e `number` |
| `address` | object | Não | Endereço próprio da pessoa, com os mesmos campos do endereço da empresa (sem `referencePoint`, que não é gravado aqui). Se omitido, o representante usa o endereço da empresa |

### Sócios adicionais

Array `additionalRepresentatives`, opcional. Cada item tem o mesmo formato do representante legal. O `idNumber` do sócio é o CPF, validado com dígitos verificadores. O envio dos documentos de cada sócio está em [Sócios e documentos](https://docs.fastpaybrasil.com/guias/fast-connect/socios-e-documentos.md).

### Conta bancária

Objeto `bankAccount`, obrigatório.

| Campo | Tipo | Obrigatório | Descrição |
| - | - | - | - |
| `bankCode` | string | Sim | Código do banco (ex.: `001`) |
| `agencyCode` | string | Sim | Agência |
| `accountNumber` | string | Sim | Número da conta |
| `accountDigit` | string | Sim | Dígito da conta |
| `accountType` | string | Sim | `checking` (corrente) ou `savings` (poupança) |
| `bankName` | string | Sim | Nome do banco |
| `recipientName` | string | Sim | Nome do titular da conta |
| `recipientDocument` | string | Sim | CPF ou CNPJ do titular, validado com dígitos verificadores |
| `routingNumber` | string | Não | Routing number, para contas dos Estados Unidos |

### Acesso ao painel

| Campo | Tipo | Obrigatório | Descrição |
| - | - | - | - |
| `canAccessDashboard` | boolean | Sim | Define se a subconta pode acessar o painel |
| `user` | object | Quando `canAccessDashboard` é `true` | Usuário do painel: `fullName`, `email` e `phone`, todos obrigatórios. O `phone` vai no formato internacional E.164, por exemplo `+5511987654321`. E-mail já cadastrado devolve `400` `Email already registered` |

## Status do credenciamento

A subconta passa por estes status ao longo da vida:

| Status | Significado | O que fazer |
| - | - | - |
| `pending` | Cadastro recebido, em análise | Envie os documentos e aguarde |
| `correcting` | A Finvia pediu correção de dados ou documentos. O motivo vem no aviso, em `rejectionReason` | Corrija e reenvie |
| `pre_approved` | Documentos obrigatórios conferidos. A subconta está sendo credenciada nas adquirentes e aguarda a aprovação final | Aguarde |
| `active` | Aprovada e apta a transacionar | Busque as chaves e libere as vendas |
| `rejected` | Reprovada | Avise o vendedor. A subconta não opera |
| `blocked` | Bloqueada | Fale com a Finvia |
| `inactive` | Inativada | Nenhuma operação |

O caminho comum é `pending`, depois `pre_approved`, depois `active`. A aprovação final só parte de `pre_approved`. O pedido de correção (`correcting`) só acontece a partir de `pending` ou `pre_approved`; depois que a correção é reenviada, a subconta volta para a análise. Uma conta `active` pode ser bloqueada (`blocked`) e desbloqueada, ou inativada (`inactive`).

O desenho abaixo mostra todas as mudanças de status possíveis. As setas pontilhadas são as mudanças que não geram aviso.

```mermaid placement="top-right" className="finvia-diagrama" theme={null}
%%{init: {"theme": "base", "fontFamily": "Inter, sans-serif", "themeVariables": {"fontFamily": "Inter, Arial, sans-serif", "fontSize": "15px", "primaryColor": "#EAF3FF", "primaryBorderColor": "#017AFF", "primaryTextColor": "#070D15", "secondaryColor": "#F3F5F8", "tertiaryColor": "#FFFFFF", "lineColor": "#5B6B82", "textColor": "#070D15", "edgeLabelBackground": "#FFFFFF", "clusterBkg": "#F7F9FC", "clusterBorder": "#D5DCE6", "actorBkg": "#FFFFFF", "actorBorder": "#98A2B3", "actorTextColor": "#070D15", "actorLineColor": "#B8C2D1", "signalTextColor": "#070D15", "labelBoxBkgColor": "#EAF3FF", "labelBoxBorderColor": "#017AFF", "labelTextColor": "#003A7A", "loopTextColor": "#070D15", "noteBkgColor": "#FFF6E5", "noteBorderColor": "#F0B44C", "noteTextColor": "#5C3D00", "activationBkgColor": "#EAF3FF", "activationBorderColor": "#017AFF", "sequenceNumberColor": "#FFFFFF", "signalColor": "#5B6B82"}, "flowchart": {"curve": "basis", "nodeSpacing": 45, "rankSpacing": 55, "padding": 18}, "sequence": {"mirrorActors": false, "showSequenceNumbers": true, "actorMargin": 60, "messageMargin": 38, "boxMargin": 10, "noteMargin": 12, "wrap": true}}}%%
flowchart TB
    S(["POST /v1/submerchants"]):::neutro
    PEN["pending<br/>em análise"]:::alerta
    COR["correcting<br/>correção pedida"]:::alerta
    PRE["pre_approved<br/>credenciando nas adquirentes"]:::alerta
    ACT["active<br/>apta a vender"]:::ok
    REJ["rejected<br/>reprovada"]:::erro
    BLK["blocked<br/>bloqueada"]:::erro
    INA["inactive<br/>inativada"]:::neutro
    S -.->|"criação"| PEN
    PEN -->|"documentos conferidos"| PRE
    PEN -->|"pede correção"| COR
    PRE -->|"pede correção"| COR
    COR -.->|"correção reenviada<br/>sem aviso"| PEN
    PRE ==>|"aprovação final"| ACT
    PEN -->|"reprovação"| REJ
    PRE -->|"reprovação"| REJ
    COR -->|"reprovação"| REJ
    ACT -->|"bloqueio"| BLK
    BLK -->|"desbloqueio"| ACT
    ACT -.->|"inativação<br/>sem aviso"| INA
    classDef ok fill:#E8F7EE,stroke:#15803D,stroke-width:1.5px,color:#0B4A23
    classDef erro fill:#FDECEC,stroke:#B42318,stroke-width:1.5px,color:#7A1209
    classDef alerta fill:#FFF6E5,stroke:#B45309,stroke-width:1.5px,color:#5C3D00
    classDef neutro fill:#FFFFFF,stroke:#B8C2D1,stroke-width:1.5px,color:#344054
```

### Status que geram aviso

Nem toda mudança gera notificação. Só estas cinco transições disparam o aviso de mudança de status:

| Status | Traz `rejectionReason`? |
| - | - |
| `pre_approved` | Não |
| `correcting` | Sim |
| `active` (aprovação e também desbloqueio) | Não |
| `rejected` | Sim |
| `blocked` | Não |

`pending` (inclusive a volta para análise depois de uma correção) e a inativação (`inactive`) **não** geram aviso. Para esses casos, consulte a subconta.

O aviso vai para o `postbackUrl` informado na criação da subconta. A URL fica salva nas configurações da subconta; para alterá-la depois, fale com o suporte. Sem `postbackUrl`, a subconta usa a URL de aviso de status da conta master, se a master tiver uma. O aviso não vai aos endpoints de webhook do painel nem ao `postbackUrl` das cobranças.

O aviso é um `POST` sem envelope, com campos em camelCase:

```json theme={null}
{
  "merchantId": "2vorkDcXyvzifL63YX09S9VqcnI",
  "status": "correcting",
  "date": "2026-01-13T12:39:48Z",
  "rejectionReason": "Documento de identidade ilegível. Reenvie o RG ou CNH com qualidade adequada."
}
```

O campo `date` é a data de referência do status e pode ser diferente do momento exato da mudança. Em `active`, por exemplo, é a data da aprovação, mesmo num desbloqueio.

> [!TIP]
>
> **Para o desenvolvedor:** responda o aviso com um status 2xx em até 10 segundos; qualquer outro resultado conta como falha de entrega. Use `merchantId` + `status` + `date` como chave para ignorar avisos repetidos e confirme o status atual com `GET /v1/submerchants/{id}`. Detalhes em [Webhooks de conta](https://docs.fastpaybrasil.com/guias/webhooks/conta.md).

## Passo a passo

### 1. Crie a subconta

```http REST (JSON) theme={null}
POST /v1/submerchants HTTP/1.1
Host: api-global.fastpaybrasil.com
Authorization: Basic <base64 de "SUA_CHAVE_SECRETA:">
Content-Type: application/json

{
  "legalName": "Ateliê Lima Cerâmicas LTDA",
  "tradeName": "Ateliê Lima",
  "companyTaxId": "11222333000181",
  "website": "https://loja.exemplo.com.br",
  "averageMonthlyRevenue": 30000,
  "averageOrderValue": 150,
  "productType": "both",
  "contactEmail": "contato@email.com",
  "productDescription": "Peças de cerâmica artesanal e aulas online de modelagem.",
  "softDescriptor": "ATELIELIMA",
  "address": {
    "addressLine1": "Av. Paulista, 1000",
    "addressLine2": "Sala 12",
    "neighborhood": "Bela Vista",
    "city": "São Paulo",
    "state": "SP",
    "country": "BRA",
    "postalCode": "01310100"
  },
  "phones": [
    {
      "type": "mobile",
      "number": "+5511987654321"
    }
  ],
  "legalRepresentative": {
    "fullName": "Ana Lima",
    "idNumber": "52998224725",
    "idType": "cpf",
    "issuingCountry": "BRA",
    "dateOfBirth": "1985-04-20",
    "nationality": "Brasileira",
    "email": "ana@email.com",
    "motherName": "Maria Souza Lima",
    "gender": "F",
    "phones": [
      {
        "type": "mobile",
        "number": "+5511987654321"
      }
    ]
  },
  "bankAccount": {
    "bankCode": "001",
    "agencyCode": "1234",
    "accountNumber": "567890",
    "accountDigit": "0",
    "accountType": "checking",
    "bankName": "Banco do Brasil",
    "recipientName": "Ateliê Lima Cerâmicas LTDA",
    "recipientDocument": "11222333000181"
  },
  "postbackUrl": "https://meusite.com.br/webhooks/finvia/subcontas",
  "canAccessDashboard": true,
  "user": {
    "fullName": "Ana Lima",
    "email": "ana@email.com",
    "phone": "+5511987654321"
  }
}
```

```bash cURL theme={null}
curl -X POST "https://api-global.fastpaybrasil.com/v1/submerchants" \
  -u "$FINVIA_API_KEY:" \
  -H "Content-Type: application/json" \
  -d '{
    "legalName": "Ateliê Lima Cerâmicas LTDA",
    "tradeName": "Ateliê Lima",
    "companyTaxId": "11222333000181",
    "website": "https://loja.exemplo.com.br",
    "averageMonthlyRevenue": 30000,
    "averageOrderValue": 150,
    "productType": "both",
    "contactEmail": "contato@email.com",
    "productDescription": "Peças de cerâmica artesanal e aulas online de modelagem.",
    "softDescriptor": "ATELIELIMA",
    "address": {
      "addressLine1": "Av. Paulista, 1000",
      "addressLine2": "Sala 12",
      "neighborhood": "Bela Vista",
      "city": "São Paulo",
      "state": "SP",
      "country": "BRA",
      "postalCode": "01310100"
    },
    "phones": [
      { "type": "mobile", "number": "+5511987654321" }
    ],
    "legalRepresentative": {
      "fullName": "Ana Lima",
      "idNumber": "52998224725",
      "idType": "cpf",
      "issuingCountry": "BRA",
      "dateOfBirth": "1985-04-20",
      "nationality": "Brasileira",
      "email": "ana@email.com",
      "motherName": "Maria Souza Lima",
      "gender": "F",
      "phones": [
        { "type": "mobile", "number": "+5511987654321" }
      ]
    },
    "bankAccount": {
      "bankCode": "001",
      "agencyCode": "1234",
      "accountNumber": "567890",
      "accountDigit": "0",
      "accountType": "checking",
      "bankName": "Banco do Brasil",
      "recipientName": "Ateliê Lima Cerâmicas LTDA",
      "recipientDocument": "11222333000181"
    },
    "postbackUrl": "https://meusite.com.br/webhooks/finvia/subcontas",
    "canAccessDashboard": true,
    "user": {
      "fullName": "Ana Lima",
      "email": "ana@email.com",
      "phone": "+5511987654321"
    }
  }'
```

```javascript Node.js theme={null}
import { readFile } from 'node:fs/promises';

const credentials = Buffer.from(`${process.env.FINVIA_API_KEY}:`).toString('base64');
// subconta.json: mesmo corpo do exemplo em cURL
const dadosDaSubconta = JSON.parse(await readFile('./subconta.json', 'utf8'));

const response = await fetch('https://api-global.fastpaybrasil.com/v1/submerchants', {
  method: 'POST',
  headers: {
    Authorization: `Basic ${credentials}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify(dadosDaSubconta),
});

const result = await response.json();
if (response.status === 201) {
  const { id, legalRepresentatives } = result; // guarde o id da subconta e os ids dos representantes
  console.log(id, legalRepresentatives);
} else {
  console.error(response.status, result.message); // 400, 409 (CNPJ já cadastrado), 403...
}
```

```python Python theme={null}
import os

import requests

payload = {
    "legalName": "Ateliê Lima Cerâmicas LTDA",
    "tradeName": "Ateliê Lima",
    "companyTaxId": "11222333000181",
    "website": "https://loja.exemplo.com.br",
    "averageMonthlyRevenue": 30000,
    "averageOrderValue": 150,
    "productType": "both",
    "contactEmail": "contato@email.com",
    "productDescription": "Peças de cerâmica artesanal e aulas online de modelagem.",
    "softDescriptor": "ATELIELIMA",
    "address": {
        "addressLine1": "Av. Paulista, 1000",
        "addressLine2": "Sala 12",
        "neighborhood": "Bela Vista",
        "city": "São Paulo",
        "state": "SP",
        "country": "BRA",
        "postalCode": "01310100",
    },
    "phones": [
        {
            "type": "mobile",
            "number": "+5511987654321",
        },
    ],
    "legalRepresentative": {
        "fullName": "Ana Lima",
        "idNumber": "52998224725",
        "idType": "cpf",
        "issuingCountry": "BRA",
        "dateOfBirth": "1985-04-20",
        "nationality": "Brasileira",
        "email": "ana@email.com",
        "motherName": "Maria Souza Lima",
        "gender": "F",
        "phones": [
            {
                "type": "mobile",
                "number": "+5511987654321",
            },
        ],
    },
    "bankAccount": {
        "bankCode": "001",
        "agencyCode": "1234",
        "accountNumber": "567890",
        "accountDigit": "0",
        "accountType": "checking",
        "bankName": "Banco do Brasil",
        "recipientName": "Ateliê Lima Cerâmicas LTDA",
        "recipientDocument": "11222333000181",
    },
    "postbackUrl": "https://meusite.com.br/webhooks/finvia/subcontas",
    "canAccessDashboard": True,
    "user": {
        "fullName": "Ana Lima",
        "email": "ana@email.com",
        "phone": "+5511987654321",
    },
}

response = requests.request(
    "POST",
    "https://api-global.fastpaybrasil.com/v1/submerchants",
    auth=(os.environ["FINVIA_API_KEY"], ""),
    json=payload,
    timeout=30,
)

print(response.status_code)
if response.content:
    print(response.json())
```

```php PHP theme={null}
<?php

$payload = [
    'legalName' => 'Ateliê Lima Cerâmicas LTDA',
    'tradeName' => 'Ateliê Lima',
    'companyTaxId' => '11222333000181',
    'website' => 'https://loja.exemplo.com.br',
    'averageMonthlyRevenue' => 30000,
    'averageOrderValue' => 150,
    'productType' => 'both',
    'contactEmail' => 'contato@email.com',
    'productDescription' => 'Peças de cerâmica artesanal e aulas online de modelagem.',
    'softDescriptor' => 'ATELIELIMA',
    'address' => [
        'addressLine1' => 'Av. Paulista, 1000',
        'addressLine2' => 'Sala 12',
        'neighborhood' => 'Bela Vista',
        'city' => 'São Paulo',
        'state' => 'SP',
        'country' => 'BRA',
        'postalCode' => '01310100',
    ],
    'phones' => [
        [
            'type' => 'mobile',
            'number' => '+5511987654321',
        ],
    ],
    'legalRepresentative' => [
        'fullName' => 'Ana Lima',
        'idNumber' => '52998224725',
        'idType' => 'cpf',
        'issuingCountry' => 'BRA',
        'dateOfBirth' => '1985-04-20',
        'nationality' => 'Brasileira',
        'email' => 'ana@email.com',
        'motherName' => 'Maria Souza Lima',
        'gender' => 'F',
        'phones' => [
            [
                'type' => 'mobile',
                'number' => '+5511987654321',
            ],
        ],
    ],
    'bankAccount' => [
        'bankCode' => '001',
        'agencyCode' => '1234',
        'accountNumber' => '567890',
        'accountDigit' => '0',
        'accountType' => 'checking',
        'bankName' => 'Banco do Brasil',
        'recipientName' => 'Ateliê Lima Cerâmicas LTDA',
        'recipientDocument' => '11222333000181',
    ],
    'postbackUrl' => 'https://meusite.com.br/webhooks/finvia/subcontas',
    'canAccessDashboard' => true,
    'user' => [
        'fullName' => 'Ana Lima',
        'email' => 'ana@email.com',
        'phone' => '+5511987654321',
    ],
];

$ch = curl_init('https://api-global.fastpaybrasil.com/v1/submerchants');

curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_USERPWD => getenv('FINVIA_API_KEY') . ':',
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => json_encode($payload),
]);

$body = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

echo $status, PHP_EOL;
print_r(json_decode($body, true));
```

```java Java theme={null}
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.util.Base64;

public class Exemplo {
    public static void main(String[] args) throws Exception {
        String credentials = Base64.getEncoder()
            .encodeToString((System.getenv("FINVIA_API_KEY") + ":").getBytes());

        String payload = """
            {
              "legalName": "Ateliê Lima Cerâmicas LTDA",
              "tradeName": "Ateliê Lima",
              "companyTaxId": "11222333000181",
              "website": "https://loja.exemplo.com.br",
              "averageMonthlyRevenue": 30000,
              "averageOrderValue": 150,
              "productType": "both",
              "contactEmail": "contato@email.com",
              "productDescription": "Peças de cerâmica artesanal e aulas online de modelagem.",
              "softDescriptor": "ATELIELIMA",
              "address": {
                "addressLine1": "Av. Paulista, 1000",
                "addressLine2": "Sala 12",
                "neighborhood": "Bela Vista",
                "city": "São Paulo",
                "state": "SP",
                "country": "BRA",
                "postalCode": "01310100"
              },
              "phones": [
                {
                  "type": "mobile",
                  "number": "+5511987654321"
                }
              ],
              "legalRepresentative": {
                "fullName": "Ana Lima",
                "idNumber": "52998224725",
                "idType": "cpf",
                "issuingCountry": "BRA",
                "dateOfBirth": "1985-04-20",
                "nationality": "Brasileira",
                "email": "ana@email.com",
                "motherName": "Maria Souza Lima",
                "gender": "F",
                "phones": [
                  {
                    "type": "mobile",
                    "number": "+5511987654321"
                  }
                ]
              },
              "bankAccount": {
                "bankCode": "001",
                "agencyCode": "1234",
                "accountNumber": "567890",
                "accountDigit": "0",
                "accountType": "checking",
                "bankName": "Banco do Brasil",
                "recipientName": "Ateliê Lima Cerâmicas LTDA",
                "recipientDocument": "11222333000181"
              },
              "postbackUrl": "https://meusite.com.br/webhooks/finvia/subcontas",
              "canAccessDashboard": true,
              "user": {
                "fullName": "Ana Lima",
                "email": "ana@email.com",
                "phone": "+5511987654321"
              }
            }
            """;

        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://api-global.fastpaybrasil.com/v1/submerchants"))
            .header("Authorization", "Basic " + credentials)
            .header("Content-Type", "application/json")
            .method("POST", HttpRequest.BodyPublishers.ofString(payload))
            .build();

        HttpResponse<String> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());

        System.out.println(response.statusCode());
        System.out.println(response.body());
    }
}
```

```csharp C# theme={null}
using System.Net.Http.Headers;
using System.Text;

var apiKey = Environment.GetEnvironmentVariable("FINVIA_API_KEY");
var credentials = Convert.ToBase64String(Encoding.UTF8.GetBytes($"{apiKey}:"));

using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Basic", credentials);

var payload = """
{
  "legalName": "Ateliê Lima Cerâmicas LTDA",
  "tradeName": "Ateliê Lima",
  "companyTaxId": "11222333000181",
  "website": "https://loja.exemplo.com.br",
  "averageMonthlyRevenue": 30000,
  "averageOrderValue": 150,
  "productType": "both",
  "contactEmail": "contato@email.com",
  "productDescription": "Peças de cerâmica artesanal e aulas online de modelagem.",
  "softDescriptor": "ATELIELIMA",
  "address": {
    "addressLine1": "Av. Paulista, 1000",
    "addressLine2": "Sala 12",
    "neighborhood": "Bela Vista",
    "city": "São Paulo",
    "state": "SP",
    "country": "BRA",
    "postalCode": "01310100"
  },
  "phones": [
    {
      "type": "mobile",
      "number": "+5511987654321"
    }
  ],
  "legalRepresentative": {
    "fullName": "Ana Lima",
    "idNumber": "52998224725",
    "idType": "cpf",
    "issuingCountry": "BRA",
    "dateOfBirth": "1985-04-20",
    "nationality": "Brasileira",
    "email": "ana@email.com",
    "motherName": "Maria Souza Lima",
    "gender": "F",
    "phones": [
      {
        "type": "mobile",
        "number": "+5511987654321"
      }
    ]
  },
  "bankAccount": {
    "bankCode": "001",
    "agencyCode": "1234",
    "accountNumber": "567890",
    "accountDigit": "0",
    "accountType": "checking",
    "bankName": "Banco do Brasil",
    "recipientName": "Ateliê Lima Cerâmicas LTDA",
    "recipientDocument": "11222333000181"
  },
  "postbackUrl": "https://meusite.com.br/webhooks/finvia/subcontas",
  "canAccessDashboard": true,
  "user": {
    "fullName": "Ana Lima",
    "email": "ana@email.com",
    "phone": "+5511987654321"
  }
}
""";

var request = new HttpRequestMessage(HttpMethod.Post, "https://api-global.fastpaybrasil.com/v1/submerchants");
request.Content = new StringContent(payload, Encoding.UTF8, "application/json");

var response = await client.SendAsync(request);
Console.WriteLine((int)response.StatusCode);
Console.WriteLine(await response.Content.ReadAsStringAsync());
```

```go Go theme={null}
package main

import (
	"fmt"
	"io"
	"net/http"
	"os"
	"strings"
)

func main() {
	payload := strings.NewReader(`{
	  "legalName": "Ateliê Lima Cerâmicas LTDA",
	  "tradeName": "Ateliê Lima",
	  "companyTaxId": "11222333000181",
	  "website": "https://loja.exemplo.com.br",
	  "averageMonthlyRevenue": 30000,
	  "averageOrderValue": 150,
	  "productType": "both",
	  "contactEmail": "contato@email.com",
	  "productDescription": "Peças de cerâmica artesanal e aulas online de modelagem.",
	  "softDescriptor": "ATELIELIMA",
	  "address": {
	    "addressLine1": "Av. Paulista, 1000",
	    "addressLine2": "Sala 12",
	    "neighborhood": "Bela Vista",
	    "city": "São Paulo",
	    "state": "SP",
	    "country": "BRA",
	    "postalCode": "01310100"
	  },
	  "phones": [
	    {
	      "type": "mobile",
	      "number": "+5511987654321"
	    }
	  ],
	  "legalRepresentative": {
	    "fullName": "Ana Lima",
	    "idNumber": "52998224725",
	    "idType": "cpf",
	    "issuingCountry": "BRA",
	    "dateOfBirth": "1985-04-20",
	    "nationality": "Brasileira",
	    "email": "ana@email.com",
	    "motherName": "Maria Souza Lima",
	    "gender": "F",
	    "phones": [
	      {
	        "type": "mobile",
	        "number": "+5511987654321"
	      }
	    ]
	  },
	  "bankAccount": {
	    "bankCode": "001",
	    "agencyCode": "1234",
	    "accountNumber": "567890",
	    "accountDigit": "0",
	    "accountType": "checking",
	    "bankName": "Banco do Brasil",
	    "recipientName": "Ateliê Lima Cerâmicas LTDA",
	    "recipientDocument": "11222333000181"
	  },
	  "postbackUrl": "https://meusite.com.br/webhooks/finvia/subcontas",
	  "canAccessDashboard": true,
	  "user": {
	    "fullName": "Ana Lima",
	    "email": "ana@email.com",
	    "phone": "+5511987654321"
	  }
	}`)

	req, err := http.NewRequest("POST", "https://api-global.fastpaybrasil.com/v1/submerchants", payload)
	if err != nil {
		panic(err)
	}
	req.SetBasicAuth(os.Getenv("FINVIA_API_KEY"), "")
	req.Header.Set("Content-Type", "application/json")

	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()

	body, _ := io.ReadAll(res.Body)
	fmt.Println(res.StatusCode)
	fmt.Println(string(body))
}
```

```ruby Ruby theme={null}
require "json"
require "net/http"
require "uri"

uri = URI("https://api-global.fastpaybrasil.com/v1/submerchants")
request = Net::HTTP::Post.new(uri)
request.basic_auth(ENV.fetch("FINVIA_API_KEY"), "")
request["Content-Type"] = "application/json"
request.body = JSON.generate({
  "legalName" => "Ateliê Lima Cerâmicas LTDA",
  "tradeName" => "Ateliê Lima",
  "companyTaxId" => "11222333000181",
  "website" => "https://loja.exemplo.com.br",
  "averageMonthlyRevenue" => 30000,
  "averageOrderValue" => 150,
  "productType" => "both",
  "contactEmail" => "contato@email.com",
  "productDescription" => "Peças de cerâmica artesanal e aulas online de modelagem.",
  "softDescriptor" => "ATELIELIMA",
  "address" => {
    "addressLine1" => "Av. Paulista, 1000",
    "addressLine2" => "Sala 12",
    "neighborhood" => "Bela Vista",
    "city" => "São Paulo",
    "state" => "SP",
    "country" => "BRA",
    "postalCode" => "01310100",
  },
  "phones" => [
    {
      "type" => "mobile",
      "number" => "+5511987654321",
    },
  ],
  "legalRepresentative" => {
    "fullName" => "Ana Lima",
    "idNumber" => "52998224725",
    "idType" => "cpf",
    "issuingCountry" => "BRA",
    "dateOfBirth" => "1985-04-20",
    "nationality" => "Brasileira",
    "email" => "ana@email.com",
    "motherName" => "Maria Souza Lima",
    "gender" => "F",
    "phones" => [
      {
        "type" => "mobile",
        "number" => "+5511987654321",
      },
    ],
  },
  "bankAccount" => {
    "bankCode" => "001",
    "agencyCode" => "1234",
    "accountNumber" => "567890",
    "accountDigit" => "0",
    "accountType" => "checking",
    "bankName" => "Banco do Brasil",
    "recipientName" => "Ateliê Lima Cerâmicas LTDA",
    "recipientDocument" => "11222333000181",
  },
  "postbackUrl" => "https://meusite.com.br/webhooks/finvia/subcontas",
  "canAccessDashboard" => true,
  "user" => {
    "fullName" => "Ana Lima",
    "email" => "ana@email.com",
    "phone" => "+5511987654321",
  },
})

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end

puts response.code
puts response.body
```

Resposta `201`:

```json theme={null}
{
  "id": "2vorkDcXyvzifL63YX09S9VqcnI",
  "legalRepresentatives": [
    {
      "id": "2vorkEaaaBbbCccDddEeeFffGgg",
      "fullName": "Ana Lima",
      "isPrimary": true
    }
  ]
}
```

Guarde o `id`: ele é usado em todas as chamadas seguintes da subconta, e é o `merchantId` dela no split e no saque.

### 2. Envie os documentos

A rota `POST /v1/submerchants/{id}/document` recebe os arquivos em `multipart/form-data`. O nome de cada campo é o tipo do documento:

| Campo | Documento | Vínculo |
| - | - | - |
| `social_contract` | Contrato social da empresa | Empresa |
| `cnpj_card` | Cartão CNPJ | Empresa |
| `responsible_document_front` | Documento de identidade do representante legal, frente | Representante legal |
| `responsible_document_back` | Documento de identidade do representante legal, verso | Representante legal |
| `selfie_with_document` | Selfie do representante legal segurando o documento | Representante legal |
| `irs_letter` | IRS letter, usada no fluxo de cadastro de LLC (empresa dos Estados Unidos) | Empresa |

Para uma empresa brasileira, o credenciamento pede contrato social, cartão CNPJ, documento do responsável frente e verso e selfie com documento; para MEI, cartão CNPJ e certificado de MEI. Não há campo próprio para o certificado de MEI: fale com o suporte para enviá-lo. A lista completa está em [Regras de credenciamento](https://docs.fastpaybrasil.com/guias/fast-connect/regras-de-credenciamento.md). É preciso enviar pelo menos um arquivo por chamada, e você pode enviar todos de uma vez.

```bash cURL theme={null}
curl -X POST "https://api-global.fastpaybrasil.com/v1/submerchants/2vorkDcXyvzifL63YX09S9VqcnI/document" \
  -u "$FINVIA_API_KEY:" \
  -F "social_contract=@contrato-social.pdf" \
  -F "cnpj_card=@cartao-cnpj.pdf" \
  -F "responsible_document_front=@rg-frente.jpg" \
  -F "responsible_document_back=@rg-verso.jpg" \
  -F "selfie_with_document=@selfie-com-rg.jpg"
```

> [!TIP]
>
> **Para o desenvolvedor:** não defina o cabeçalho `Content-Type` manualmente em envios multipart. O cURL (com `-F`) e as bibliotecas HTTP montam o cabeçalho com o separador (`boundary`) correto. A resposta de sucesso é `201`, sem corpo.

> [!NOTE]
>
> Esta rota vincula os documentos de pessoa sempre ao **representante legal**. Se a empresa tem só um representante, ela é tudo o que você precisa. Para documentos de sócios adicionais, ou para receber os arquivos direto do navegador do vendedor sem expor a sua chave, use o fluxo com token descrito em [Sócios e documentos](https://docs.fastpaybrasil.com/guias/fast-connect/socios-e-documentos.md).

### 3. Consulte até `active`

```bash cURL theme={null}
curl -X GET "https://api-global.fastpaybrasil.com/v1/submerchants/2vorkDcXyvzifL63YX09S9VqcnI" \
  -u "$FINVIA_API_KEY:"
```

O campo `status` da resposta mostra a situação atual. Quando a subconta é aprovada, `approvedAt` passa a ter a data da aprovação. Use o aviso de mudança de status como gatilho principal e a consulta para confirmar ou para casos sem aviso (como `pending` e `inactive`).

Para acompanhar várias subcontas, `GET /v1/submerchants` aceita o filtro `status` com os sete valores. Para mais de um status, repita o parâmetro: `?status=pending&status=correcting`. Veja os demais filtros em [Listar subcontas](https://docs.fastpaybrasil.com/referencia/fast-connect/listar-subcontas.md).

### 4. Obtenha as chaves da subconta

```bash cURL theme={null}
curl -X GET "https://api-global.fastpaybrasil.com/v1/submerchants/2vorkDcXyvzifL63YX09S9VqcnI/api-keys" \
  -u "$FINVIA_API_KEY:"
```

```json 200 theme={null}
{
  "publicKey": "pk_2vorkDcXyvzifL63YX09S9VqcnI",
  "secretKey": "sk_2vorkDcXyvzifL63YX09S9VqcnI"
}
```

Se a subconta não tiver chaves, a resposta é:

```json 404 theme={null}
{ "statusCode": 404, "message": "API keys not found for this submerchant." }
```

Em modo de teste, as chaves vêm com prefixo `sk_test_` e `pk_test_`.

> [!WARNING]
>
> A `secretKey` é a chave secreta da subconta: com ela, a sua plataforma cria cobranças em nome da subconta. Guarde em cofre de segredos, no servidor, associada ao `id` da subconta. Nunca envie a chave secreta para o vendedor por e-mail ou mensagem, nem para o navegador.

### 5. Corrija um cadastro em `correcting`

Quando a Finvia pede correções, o aviso chega com `status` `correcting` e o motivo em `rejectionReason`. A correção dos dados é feita pelo painel da Finvia, na gestão de subcontas (a API não oferece essa operação).

Depois do reenvio, a subconta volta para a análise. O status `rejected` indica que o cadastro foi reprovado.

> [!NOTE]
>
> **Para o negócio:** combine com o time de operação quem acompanha as correções pendentes no painel. Uma boa prática é mostrar o `rejectionReason` ao vendedor na sua plataforma, coletar o dado ou documento correto e só então fazer a correção no painel.

## Erros comuns

| Sintoma | Causa | Como resolver |
| - | - | - |
| `400` na criação, com `message` em lista | Campo obrigatório ausente, enum inválido, país em alpha-2 (`BR`) ou documento com dígito verificador inválido | Confira os blocos obrigatórios desta página e os valores de `productType`, `gender`, `accountType` e `country` |
| `400` `Email already registered` | Já existe usuário do painel com o e-mail de `user.email` | Use outro e-mail |
| `409` com "Já existe um cadastro com este CNPJ" | CNPJ já cadastrado em outra subconta da mesma master ou igual ao da master | Procure a subconta existente com `companyTaxId` em [Listar subcontas](https://docs.fastpaybrasil.com/referencia/fast-connect/listar-subcontas.md) |
| Criação rejeitada com `canAccessDashboard: true` | Objeto `user` ausente ou telefone fora do E.164 | Envie `user` com `fullName`, `email` e `phone` no formato `+5511987654321` |
| `400` no envio de documentos | Formato não aceito, arquivo acima de 50 MB, nenhum arquivo ou nome de campo inválido | Use JPEG, JPG, PNG, GIF, BMP, WEBP ou PDF até 50 MB e os nomes de campo desta página |
| `422` no envio de documentos | Subconta já aprovada | Depois da aprovação, novos envios são bloqueados |
| `404` com "API keys not found for this submerchant." | A subconta não tem chaves | Confira o status da subconta e tente de novo depois da aprovação |
| Nenhum aviso chega para `pending` ou `inactive` | Esses status não geram aviso | Consulte a subconta com `GET /v1/submerchants/{id}` |
| `401` | Chave inválida ou mal formatada | Veja [Credenciais e ambientes](https://docs.fastpaybrasil.com/primeiros-passos/credenciais-e-ambientes.md) |

As mensagens de erro misturam português e inglês. Trate o erro pelo código HTTP, sem depender do texto da mensagem.

## Perguntas frequentes

> [accordion] Posso enviar os documentos em várias chamadas?
>
> Sim. Cada chamada precisa ter pelo menos um arquivo. Você pode mandar os documentos da empresa em uma chamada e os do representante em outra.

> [accordion] Consigo trocar um documento depois que a subconta foi aprovada?
>
> Não pela API. Depois da aprovação, novos envios são bloqueados e a rota responde `422`.

> [accordion] O endereço do representante é obrigatório?
>
> Não. Se você não enviar `legalRepresentative.address`, o representante usa o endereço da empresa.

> [accordion] Como sei por que a subconta foi recusada?
>
> O aviso de mudança de status traz o campo `rejectionReason` quando o status é `rejected` ou `correcting`. Para ver o status de cada documento de pessoa, use a listagem de representantes com `include=documents` ([Sócios e documentos](https://docs.fastpaybrasil.com/guias/fast-connect/socios-e-documentos.md)).

> [accordion] A subconta precisa de acesso ao painel?
>
> Não é obrigatório. Defina `canAccessDashboard` como `false` se a sua plataforma vai oferecer toda a experiência ao vendedor. Com `true`, informe o `user` que vai acessar o painel.

> [accordion] Para que serve o softDescriptor?
>
> É o nome que aparece na fatura do cartão do cliente, com até 40 caracteres.

> [accordion] Quanto tempo leva a análise?
>
> O tempo médio de credenciamento é de até 24 horas, e é mais rápido quando não há divergência nos documentos. Veja [Regras de credenciamento](https://docs.fastpaybrasil.com/guias/fast-connect/regras-de-credenciamento.md).

## Como testar

Cenários do [roteiro de homologação](https://docs.fastpaybrasil.com/homologacao/roteiro.md):

| Código | O que comprovar |
| - | - |
| FC-01 | Criar a subconta com todos os campos obrigatórios e guardar o `id` |
| FC-02 | Enviar um documento de cada tipo (contrato social, cartão CNPJ, documento frente e verso, selfie) |
| FC-03 | Consultar a subconta até o status `active` |
| FC-04 | Obter as chaves da subconta ativa |
| FC-08 | Receber o aviso de mudança de status e responder com HTTP 2xx |

## Veja também

> [card] [Sócios e documentos](https://docs.fastpaybrasil.com/guias/fast-connect/socios-e-documentos.md)
>
> Sócios adicionais e envio de documentos com token.

> [card] [Webhooks de conta](https://docs.fastpaybrasil.com/guias/webhooks/conta.md)
>
> Formato completo do aviso de mudança de status.

> [card] [Criar subconta](https://docs.fastpaybrasil.com/referencia/fast-connect/criar-subconta.md)
>
> Referência completa da rota.

> [card] [Regras de credenciamento](https://docs.fastpaybrasil.com/guias/fast-connect/regras-de-credenciamento.md)
>
> Documentos exigidos, motivos de recusa e MCCs não aceitos.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.