Rotas Auxiliares

As rotas auxiliares (whitelabel) permitem redirecionar o usuário para telas hospedadas pela Meaple, como:

reembolso de pedidos
edição de perfil

Essas rotas pressupõem que o usuário já esteja autenticado na sua aplicação.

Personalização por parâmetros de URL

As páginas podem ser personalizadas por query params para manter consistência visual com seu produto:

theme: tema da página (dark ou light)
primary_color: cor primária em hex (sem #)

Dependendo da rota, outros parâmetros também podem ser necessários, como client_id e callbackUrl.

Rota de reembolso

Use esta rota para enviar o usuário para a página de reembolso de um evento específico:


const params = new URLSearchParams({
  theme: process.env.NEXT_PUBLIC_THEME ?? '',
  primary_color: `${process.env.NEXT_PUBLIC_PRIMARY_COLOR}`,
});
 
const refundUrl = `${process.env.NEXT_PUBLIC_MEAPLE_OAUTH_URL}/whitelabel/${eventId}/refund?${params.toString()}`;
 
window.location.href = refundUrl;

Quando usar

Quando você quer que o usuário solicite reembolso em uma tela hospedada pela Meaple, sem precisar implementar esse fluxo na sua aplicação.

Exemplo da tela de reembolso:

Tela de reembolso

Rota de edição de perfil

Use esta rota para enviar o usuário para a página de edição de perfil hospedada:


const params = new URLSearchParams({
  client_id: process.env.NEXT_PUBLIC_MEAPLE_CHANNEL_ID ?? '',
  theme: process.env.NEXT_PUBLIC_THEME ?? '',
  primary_color: `${process.env.NEXT_PUBLIC_PRIMARY_COLOR}`,
  callbackUrl: process.env.NEXT_PUBLIC_APP_URL ?? '',
});
 
const url = `${process.env.NEXT_PUBLIC_MEAPLE_OAUTH_URL}/whitelabel/profile?${params.toString()}`;
 
window.location.href = url;

Exemplo da tela de edição de perfil:

Parâmetros

client_id: ID do canal Meaple (mesmo usado na autenticação)
theme: tema da página (dark ou light)
primary_color: cor primária em hex (sem #)
callbackUrl: URL da sua aplicação para redirecionamento após salvar/cancelar

Após retorno via callback

Você pode consultar os dados atualizados do usuário com:


const user = await sdk.users.getMe();

Retorno: GetMeUserProps