# Configurações (/docs/dev/api/configuracoes)

## 🔍 Buscar Configurações [#-buscar-configurações]

<div className="flex items-center gap-2 my-4 font-mono text-sm">
  <span className="bg-blue-500/15 text-blue-400 border border-blue-500/30 px-2 py-0.5 rounded font-bold">GET</span>
  <code>/guilds/\{guildId\}/configs</code>
</div>

### Resposta [#resposta]

```json
{
  "id": "clx...",
  "guildId": "123456789",
  "name": "Minha Loja",
  "description": "A melhor loja do Discord",
  "colorHex": "#00ff00",
  "logoUrl": "https://...",
  "bannerUrl": "https://...",
  "channels": {
    "sales": "987654321",
    "orders": "987654322",
    "logs": "987654323"
  },
  "roles": {
    "admin": "111111111",
    "customer": "222222222"
  },
  "providers": ["pixsemiauto", "mercadoPago"]
}
```

---

## ✏️ Atualizar Configurações [#️-atualizar-configurações]

<div className="flex items-center gap-2 my-4 font-mono text-sm">
  <span className="bg-yellow-500/15 text-yellow-400 border border-yellow-500/30 px-2 py-0.5 rounded font-bold">PATCH</span>
  <code>/guilds/\{guildId\}/configs</code>
</div>

Todos os campos são opcionais. Envie apenas o que deseja alterar.

### 🎨 Identidade [#-identidade]

<TypeTable
  type={{
    name: { description: "Nome da loja.", type: "string" },
    description: { description: "Descrição da loja.", type: "string" },
    colorHex: { description: "Cor principal dos embeds (ex: `#00ff00`).", type: "string" },
    logoUrl: { description: "URL da logo.", type: "string" },
    bannerUrl: { description: "URL do banner.", type: "string" },
  }}
/>

### 📢 Canais [#-canais]

<TypeTable
  type={{
    "channels.sales": { description: "Canal onde as vendas são notificadas.", type: "string (ID do canal)" },
    "channels.orders": { description: "Canal onde os pedidos são enviados.", type: "string (ID do canal)" },
    "channels.logs": { description: "Canal de logs internos.", type: "string (ID do canal)" },
  }}
/>

### 🛡️ Cargos [#️-cargos]

<TypeTable
  type={{
    "roles.admin": { description: "Cargo com acesso administrativo ao bot.", type: "string (ID do cargo)" },
    "roles.customer": { description: "Cargo atribuído automaticamente aos compradores.", type: "string (ID do cargo)" },
  }}
/>

### 💳 Provedores de Pagamento [#-provedores-de-pagamento]

<TypeTable
  type={{
    providers: { description: "Lista de provedores de pagamento ativos.", type: "string[]" },
  }}
/>

| Valor | Descrição |
|-------|-----------|
| `pixsemiauto` | PIX manual (copia e cola) |
| `mercadoPago` | PIX automático via Mercado Pago |
| `pagseguro` | PIX automático via PagSeguro |
| `asaas` | PIX automático via Asaas |
| `efibank` | PIX automático via EFI Pay |
| `wallet` | Carteira interna |
| `stripe` | Cartão de crédito/débito via Stripe |
| `nowpayments` | Criptomoedas via NowPayments |

<Callout type="warn">
  Alterar canais ou cargos com IDs incorretos pode quebrar o fluxo de vendas. Verifique os IDs antes de atualizar.
</Callout>