Skip to main content
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. 
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
Detalhes da personalização

​
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. 
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
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).
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: 
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"
  }'
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.