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

# Tema personalizado para o Link

> Aprenda a configurar o tema personalizado para o Link de Pagamento, com as cores, logo e URL do Link de Pagamento.

Para configurar o tema personalizado para o Link de Pagamento, você deve utilizar a API de Settings. Você pode ler mais detalhes sobre a configuração de um Link de Pagamento na [**especificação da API**](/api-reference/settings/criar-configuracao-de-link-de-pagamento).

<CodeGroup>
  ```bash Request theme={null}
  curl --request POST \
    --url https://api.malga.io/v1/settings \
    --header 'Content-Type: multipart/form-data' \
    --header 'X-Api-Key: <YOUR_API_KEY>' \
    --header 'X-Client-Id: <YOUR_CLIENT_ID>' \
    --form 'mainColor=#000000' \
    --form 'SecondaryColor=#FFFFFF' \
    --form 'attentionColor=#FF0000' \
    --form 'errorColor=#FF0000' \
    --form 'successColor=#00FF00' \
    --form 'backgroundColor=#FFFFFF' \
    --form 'logo=@"/C:/Users/caminho/para/a/imagem/logo.jpg"' \
    --form companyUrl=https://www.company.com
  ```

  ```bash Response theme={null}
  {
    "id": "id da setting",
    "clientId": "id da setting",
    "mainColor": "#000000",
    "SecondaryColor": "#FFFFFF",
    "attentionColor": "#FF0000",
    "errorColor": "#FF0000",
    "successColor": "#00FF00",
    "backgroundColor": "#FFFFFF",
    "logo": "https://url.com/logo.jpg",
    "companyUrl": "https://www.company.com"
    "merchantId": ""
  }
  ```
</CodeGroup>

<Frame>
  <img src="https://mintcdn.com/malga/IOVOnIAezUBL8DiW/assets/images/dashboard/payment-link/payment-link-theme-light.png?fit=max&auto=format&n=IOVOnIAezUBL8DiW&q=85&s=336d034873fa05d0914a6e3d91e00808" alt="Detalhes da personalização" lightAlt="Detalhes da personalização" darkAlt="Detalhes da personalização" className="dark:hidden" width="3840" height="3051" data-path="assets/images/dashboard/payment-link/payment-link-theme-light.png" />

  <img src="https://mintcdn.com/malga/4UvHKG_GFhwE0MkA/assets/images/dashboard/payment-link/payment-link-theme.png?fit=max&auto=format&n=4UvHKG_GFhwE0MkA&q=85&s=9a186fe7e01f91c468e216d68722152c" alt="Detalhes da personalização" lightAlt="Detalhes da personalização" darkAlt="Detalhes da personalização" className="hidden dark:block" width="1280" height="1017" data-path="assets/images/dashboard/payment-link/payment-link-theme.png" />
</Frame>

## Tema por Merchant

Se você possui múltiplos merchants, é possível configurar um tema específico para cada um. Para isso, envie o header `X-Merchant-Id` na chamada de criação ou atualização de settings.

Quando um Link de Pagamento é gerado para uma sessão com `merchantId`, o sistema busca automaticamente a configuração do merchant. Caso não exista configuração específica, o tema padrão do cliente é utilizado como fallback.

<CodeGroup>
  ```bash Request theme={null}
  curl --request POST \
    --url https://api.malga.io/v1/settings \
    --header 'Content-Type: multipart/form-data' \
    --header 'X-Api-Key: <YOUR_API_KEY>' \
    --header 'X-Client-Id: <YOUR_CLIENT_ID>' \
    --header 'X-Merchant-Id: <YOUR_MERCHANT_ID>' \
    --form 'mainColor=#39BFAD' \
    --form 'SecondaryColor=#FFFFFF' \
    --form 'attentionColor=#FFA500' \
    --form 'errorColor=#FF0000' \
    --form 'successColor=#00AA00' \
    --form 'backgroundColor=#F5F5F5' \
    --form 'logo=@"/caminho/para/logo-merchant.png"' \
    --form companyUrl=https://www.merchant.com
  ```

  ```bash Response theme={null}
  {
    "id": "uuid-da-setting",
    "clientId": "id-do-cliente",
    "mainColor": "#39BFAD",
    "SecondaryColor": "#FFFFFF",
    "attentionColor": "#FFA500",
    "errorColor": "#FF0000",
    "successColor": "#00AA00",
    "backgroundColor": "#F5F5F5",
    "logo": "https://url.com/logo-merchant.png",
    "companyUrl": "https://www.merchant.com",
    "merchantId": "df601922-e024-6394-8f12-af21ec4218b1"
  }
  ```
</CodeGroup>

<Info>
  O campo `merchantId` na resposta indica se a configuração retornada é específica do merchant (id do merchant) ou a configuração padrão do cliente (nesse caso sem valor).
</Info>

## Personalizando a URL do Link

Para personalizar a URL do Link de Pagamento, utilize o parâmetro `companyUrl` na API de Settings. Além disso, entre em contato com o time de atendimento Malga para configurar o domínio do Link de Pagamento.

Para **atualizar** apenas a URL (sem reenviar logo ou cores), use `PATCH` com JSON:

<CodeGroup>
  ```bash Request (JSON) theme={null}
  curl --request PATCH \
    --url https://api.malga.io/v1/settings \
    --header 'Content-Type: application/json' \
    --header 'X-Api-Key: <YOUR_API_KEY>' \
    --header 'X-Client-Id: <YOUR_CLIENT_ID>' \
    --data '{
      "companyUrl": "https://www.company.com"
    }'
  ```

  ```bash Request (multipart) theme={null}
  curl --request PATCH \
    --url https://api.malga.io/v1/settings \
    --header 'Content-Type: multipart/form-data' \
    --header 'X-Api-Key: <YOUR_API_KEY>' \
    --header 'X-Client-Id: <YOUR_CLIENT_ID>' \
    --form 'companyUrl=https://www.company.com'
  ```
</CodeGroup>

<Info>
  Enviar `companyUrl` vazio ou um body JSON `{}` retorna **422** (`No fields to update`) — a API não interpreta isso como remoção do valor. Para alterar a URL, envie o novo valor completo.
</Info>