Personalização do Parceiro

Antes do registro, busque a configuração do parceiro (white label). Ela traz a identidade visual, os IDs de escopo (que viram headers nas chamadas), o schema dinâmico de registro, os botões da dashboard, os documentos legais e a personalização do comprovante.

suspend fun getTerminalConfig(slug: String): TerminalConfigResponse

val config = posPinpad.getTerminalConfig(slug = "partner-slug")

// Identidade visual
applyTheme(config.partner.primaryColor)
loadLogo(config.partner.logoUrl)
setTitle(config.partner.brandName)

// Campos a renderizar na tela de registro
config.registrationSchema?.fields?.forEach { field ->
    renderField(id = field.id, label = field.label, type = field.type)
}

// Funcionalidades habilitadas para o parceiro
val estornoVisivel = config.dashboardButtons?.get(DashboardFeature.REFUND)?.visible ?: true

Campo	Uso
`partner`	Marca: nome, cor primária, logos, telefone de suporte, site e fonte
`scope`	Identificadores de organização do parceiro
`registrationSchema`	Formulário de cadastro usado em `register`
`dashboardButtons`	Funcionalidades habilitadas e se exigem senha
`legalDocuments`	Política de privacidade e termos de uso
`receiptCustom`	Personalização do comprovante (título, descrição, telefone da ouvidoria)

Erros

getTerminalConfig lança TerminalConfigException em caso de falha. A subclasse PartnerNotFoundException indica que o parceiro não existe no ambiente e expõe o slug consultado: é um erro permanente, não tente de novo automaticamente. Veja Exceções.

Veja TerminalConfigResponse para a estrutura completa.

Erros​

Erros