Tema personalizado para o Link

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

{
  "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": ""
}

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

{
  "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"
}

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).

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:

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"
  }'

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'

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.

Comece na Malga

Conexões

Guias

Serviços adicionais

Tema personalizado para o Link

Tema por Merchant

Personalizando a URL do Link

​Tema por Merchant

​Personalizando a URL do Link

Tema por Merchant

Personalizando a URL do Link