Skip to main content
Disponível a partir da v0.8.0. Plataformas B2B2C que modelam professores / coaches / prestadores como Products sob um único Seller podem ter logo, cor e mensagens próprias por profissional, sem fragmentar a contabilidade do seller.

​
Quando usar

  • SaaS de coaching que cobra por professor
  • Plataforma de cursos onde cada instrutor tem branding próprio
  • Marketplace administrativo onde vendedores são representados como Products
Para casos B2C simples (uma única marca por seller), use a configuração de portal a nível de seller.

​
Endpoints

Base: /api/products/{productId}/portal-config
{productId} aceita o UUID do produto (recomendado — é o identificador estável e não-enumerável retornado por GET /api/products e por list_products no MCP) ou o id numérico legado. Os dois funcionam; a partir da v0.10.0 o UUID é o caminho preferido.

​
GET — ler config atual

Retorna a config persistida ou null se o produto não tem customização (cai no fallback do seller).

​
POST / PATCH — upsert com merge

Mesma semântica em ambos: só os campos enviados são gravados; os omitidos preservam o valor anterior. Mande null num campo para herdar do seller. 
{
  "businessName": "Coach Maria — Corrida & Trilha",
  "primaryColor": "#257264",
  "logoUrl": "https://cdn.exemplo.com/coaches/maria.png",
  "customWelcomeText": "Bem-vinda à equipe da Maria!"
}

​
DELETE — limpar tudo

Remove a row inteira; o produto volta a usar a config do seller.

​
Campos

​
Branding

CampoTipoDescrição
businessNamestring | nullNome exibido no header da página de pagamento
logoUrlstring | nullURL HTTPS de logo (max 500 chars)
primaryColorstring | nullCor primária em hex (#257264 ou #abc)

​
Políticas do portal /minha-area

CampoTipoDefault herdado
allowCancelSubscriptionboolean | nullseller
allowUpdatePaymentMethodboolean | nullseller
allowUpdateBillingInfoboolean | nullseller
allowViewInvoicesboolean | nullseller
allowApplyCouponsboolean | nullseller
requireCancelReasonboolean | nullseller
cancelAtPeriodEndOnlyboolean | nullseller

​
E-mails transacionais

CampoTipo
sendCancellationEmailboolean | null
sendPaymentMethodUpdatedEmailboolean | null

​
Mensagens customizadas

CampoTipoLimite
customSuccessMessagestring | null500 chars
customCancellationMessagestring | null500 chars
customWelcomeTextstring | null500 chars

​
Exemplo: SaaS de coaching

# Coach 1 (Maria) — verde, com mensagem própria
curl -X POST https://garu.com.br/api/products/a1b2c3d4-e5f6-7890-abcd-ef1234567890/portal-config \
  -H "Authorization: Bearer $GARU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "businessName": "Coach Maria — Corrida & Trilha",
    "primaryColor": "#257264",
    "logoUrl": "https://cdn.atletia.com.br/coaches/maria.png",
    "customWelcomeText": "Bem-vinda ao plano de corrida!"
  }'

# Coach 2 (Jefter) — laranja, sem custom message (herda do seller)
curl -X POST https://garu.com.br/api/products/b2c3d4e5-f6a7-8901-bcde-f23456789012/portal-config \
  -H "Authorization: Bearer $GARU_API_KEY" \
  -d '{
    "businessName": "Jefter — Instrutor de Corridas",
    "primaryColor": "#CB9454",
    "logoUrl": "https://cdn.atletia.com.br/coaches/jefter.png"
  }'
Quando o cliente paga um produto do Jefter, ele vê laranja + nome dele. Pagando um da Maria, vê verde + nome dela. Mas a transação aparece para o seller “Atletia” no dashboard — uma única conta, uma única contabilidade.

​
SDK

import { Garu } from '@garuhq/node';
const garu = new Garu({ apiKey: process.env.GARU_API_KEY! });

// O SDK ainda assina como `number`; chame com o id numérico ou faça a chamada
// direta via REST se preferir o UUID. Wrapper UUID-first vem num release próximo.
await garu.products.portalConfig.set(57, {
  businessName: 'Coach Maria — Corrida & Trilha',
  primaryColor: '#257264'
});

​
MCP

Agentes podem customizar o portal por produto direto pela ferramenta:
  • set_product_portal_config — upsert com merge
  • get_product_portal_config — ler config atual
  • clear_product_portal_config — limpar tudo