Admin

Integração com Seguro de Aventura (Roca Seguros)

Nossa integração nativa com o Seguro de Aventura da Roca Seguros permite a emissão automática de seguros para os seus clientes, otimizando a operação do seu negócio. Requisitos Prévios - Estar em um dos planos pagos da mymento: PRO, PLUS ou ENTERPRISE. - Possuir uma apólice ativa diretamente com a Roca Seguros. ⚠️ Importante: A mymento é responsável exclusivamente pela automação do envio de dados e emissão do seguro conforme as suas configurações. O contrato, faturamento, coberturas e eventuais indenizações são tratados diretamente entre você, seu cliente e a Roca Seguros. Passo a Passo para Configuração 1. Ativar a Conexão no Painel No painel administrativo da mymento, acesse Configurações > Conexões e localize a seção "Seguro de Aventura". Em seguida, clique em Conectar. 2. Configurar os Parâmetros da Apólice Preencha os campos necessários para alinhar a automação ao seu modelo de operação: - Número da Apólice: Informe o número de 14 dígitos fornecido pela Roca Seguros. - Antecedência: Defina com quanto tempo de antecedência o seguro deve ser emitido. Por padrão, a emissão ocorre no exato momento programado para o início da atividade, mas você pode estipular um prazo maior. - Agrupamento de Eventos: Por padrão, o sistema unifica os participantes em um único evento diário no Seguro de Aventura. Se preferir individualizar, ative a opção "Criar eventos individuais para cada reserva". - Nota: Para experiências que duram mais de um dia, o sistema criará automaticamente um evento exclusivo para cada reserva. Clique em Salvar para registrar as configurações iniciais. ⚠️ Atenção: Todas as alterações e novas configurações aplicam-se exclusivamente às novas reservas integradas ao sistema após a ativação. Reservas criadas anteriormente não serão afetadas retroativamente. 3. Vincular o Seguro às Atividades Você tem total flexibilidade para escolher quais experiências do seu catálogo contarão com a emissão automática: 1. Acesse o seu catálogo em Atividades (ou diretamente via admin.mymento.com.br/products). 2. Ao lado da atividade desejada, clique em Mais opções > Formulários. 4. Customizar a Captura de Dados dos Participantes Ao ativar o seguro na atividade, o sistema criará automaticamente 3 campos obrigatórios para cada participante: Nome Completo, Data de Nascimento e Documento (CPF ou passaporte). - Quantas fichas?: Se a sua atividade utiliza configurações avançadas (como quantidade variável de pessoas), ajuste este campo para determinar o número necessário de formulários. - Momento do Preenchimento: Escolha a estratégia ideal para o seu fluxo de checkout: - Preencher depois do pagamento: Prioriza a conversão de vendas. O cliente finaliza o pagamento rapidamente e insere os dados dos acompanhantes depois. Atenção: Existe o risco de o cliente esquecer de preencher os dados posteriormente. - Preencher antes do pagamento: Garante que 100% das reservas entrem no sistema com os dados preenchidos. Atenção: O processo de compra se torna mais longo, o que pode impactar a taxa de conversão se o cliente não tiver os dados de todos os acompanhantes em mãos. Clique em Salvar para concluir o vínculo. Como Verificar a Emissão do Seguro Para garantir a segurança da operação, certifique-se de que a emissão foi realizada antes do início da atividade: 1. Acesse o menu de Vendas e localize a reserva desejada. 2. Clique na aba Participantes. 3. Na coluna Seguro, você visualizará o número do bilhete emitido. Esse código também pode ser utilizado para consultas diretamente no portal da Roca Seguros. Sinistros e Ocorrências Em caso de sinistros, o acionamento deve ser feito diretamente com a seguradora parceira. Disponibilize ou acesse o link oficial para abertura do processo: Abertura de Sinistro - Seguro de Aventura.

Webhooks: Notificações automáticas e em tempo real

Um Webhook permite que a mymento envie notificações automáticas para o seu sistema em tempo real por meio de requisições HTTP POST. Com ele, você recebe avisos instantâneos sobre eventos importantes — como novas vendas ou atualizações de status — eliminando a necessidade de consultar a API da mymento constantemente (polling). Como Funciona 1. Destino: Você configura uma URL HTTPS segura do seu servidor. 2. Disparo: Sempre que o evento configurado ocorrer (ex: criação ou alteração de uma reserva), a mymento dispara uma requisição POST para a sua URL. 3. Payload: O corpo da requisição contém um objeto JSON detalhado com o tipo da ação (create ou update) e os dados completos da venda. 4. Segurança (Opcional): Você pode definir um token de validação. Ele será enviado no cabeçalho X-Webhook-Token da requisição, permitindo que seu servidor verifique a autenticidade da origem. 5. Timeout: O tempo máximo que o seu servidor tem para responder à requisição é de 15 segundos. ⚠️ Requisito Prévio: O uso de Webhooks requer que o módulo de API esteja devidamente contratado e ativo em sua conta mymento. Passo a Passo para Configuração 1. Acesse o painel administrativo em Configurações > Conexões > Webhook > Configurar. 2. No campo correspondente, insira a URL HTTPS do seu sistema que receberá os dados. 3. Selecione quais tipos de evento (gatilhos) sua aplicação deseja escutar. 4. (Opcional) Defina uma chave secreta no campo Token de Validação para aumentar a segurança do seu endpoint. Estrutura do JSON Enviado (Payload) Abaixo, veja um exemplo prático do objeto JSON enviado pela mymento em uma ação de atualização (update):

Como receber pagamentos na mymento

Ao vender ingressos, passeios ou experiências na mymento, você precisa definir como seus clientes realizarão os pagamentos. O sistema oferece duas modalidades de fluxo: Confirmação Manual e Confirmação Automática. 1. Pagamentos com Confirmação Manual (Formato Padrão) Por padrão, as novas contas são configuradas para a validação manual de pagamentos. - Como funciona: O cliente visualiza a sua chave Pix na tela de sucesso após finalizar a compra, realiza a transferência no banco dele e envia o comprovante de pagamento para você via WhatsApp. - Ação necessária: Você deve acessar o painel administrativo (via navegador ou aplicativo móvel), localizar a reserva correspondente e clicar em Confirmar Pagamento. Somente após essa ação o status da reserva é atualizado e o voucher é disparado automaticamente para o e-mail do cliente. - Pontos de atenção: Embora seja o método mais simples e sem custos extras de intermediação, ele exige trabalho manual para cada venda realizada e limita seus recebimentos exclusivamente ao Pix (sem opção de cartão de crédito). 2. Pagamentos com Confirmação Automática (Recomendado) Para receber via Pix e Cartão de Crédito e liberar seus vouchers instantaneamente sem qualquer intervenção humana, você precisa conectar um intermediador de pagamento. Intermediadores são instituições financeiras homologadas pela mymento que processam a transação com segurança e notificam o nosso sistema em tempo real assim que o pagamento é aprovado. Cada instituição cobra taxas por transação que variam conforme o seu volume de vendas e a negociação direta com eles. Atualmente, a mymento possui integração nativa com os seguintes parceiros: - Asaas (Parceiro oficial com condições exclusivas) - PagBank - PayPal - Pagar.me - Getnet - Cielo - Rede (via MaxiPago) - InfinitePay Passo a Passo: Integrando com o Asaas (Fluxo Facilitado) A mymento possui uma parceria estratégica com o Asaas, oferecendo tarifas diferenciadas e um processo de abertura de conta simplificado, realizado diretamente pelo nosso painel. 1. No menu do admin, acesse Admin > Formas de Recebimento. 2. Clique em Conectar um intermediador. 3. Selecione a primeira opção: "Asaas + mymento". 4. Avalie as condições e tarifas comerciais exibidas na tela com atenção. 5. Preencha os dados solicitados da sua empresa e dê o aceite nos termos e condições. 6. Clique em Conectar. 7. Você receberá um e-mail do Asaas com as instruções de conformidade. Será necessário baixar o aplicativo do Asaas para o envio de documentos de verificação e validação de identidade (selfie). 8. Assim que sua conta for aprovada pelo compliance do Asaas, você receberá um e-mail de confirmação. 9. Volte ao menu Formas de Recebimento na mymento e, na primeira seção da página, selecione a sua nova conta Asaas como o intermediador oficial para Pix e Cartão de Crédito. 10. Clique em Salvar. Passo a Passo: Utilizando Outros Intermediadores Caso prefira utilizar qualquer uma das outras bandeiras homologadas, o processo de abertura é feito externamente: 1. Acesse o site do intermediador de sua escolha e crie a conta comercial da sua empresa. 2. Após a aprovação da conta junto à credenciadora, acesse o painel da mymento em Admin > Formas de Recebimento. 3. Clique em Conectar um intermediador. 4. Selecione a opção correspondente ciente das taxas de integração da plataforma. 5. Escolha o intermediador desejado na lista e siga as instruções específicas de configuração em tela (inserção de chaves de API, tokens ou credenciais). 💡 Nota: Como as etapas de integração de credenciais variam de acordo com o painel de cada instituição financeira, caso tenha dúvidas durante o processo, entre em contato diretamente com o nosso time de suporte. Guias para Outros Intermediadores - Integrar com o pagar.me - Integrar com o PagBank

Automatizar a emissão de notas fiscais de serviço com a FocusNFe

A mymento possui integração nativa com a FocusNFe para automatizar a emissão de Notas Fiscais de Serviço Eletrônicas (NFS-e) para os seus clientes. O gatilho de emissão ocorre de forma automatizada sempre que uma venda é finalizada no sistema. Requisitos Prévios - Possuir uma conta ativa e um plano contratado diretamente com a FocusNFe (em caso de dúvidas comerciais, trate diretamente com o time deles). - Cadastrar sua empresa e realizar o upload do seu Certificado Digital (A1) dentro do painel da FocusNFe. - Verificar se o seu município é homologado para emissão automática. Você pode consultar a lista oficial aqui: Municípios Integrados - FocusNFe. Passo a Passo para Configuração 1. Obter o Token de Produção na FocusNFe 1. Acesse o seu painel na FocusNFe e vá para a seção de tokens de API (ou clique direto em app-v2.focusnfe.com.br/painel_api/tokens). 2. Clique no ícone de "olho" ao lado do campo "Token principal produção" para revelar a chave. 3. Copie o token gerado. 2. Ativar a Conexão na mymento 1. No painel administrativo da mymento, acesse Configurações > Conexões e localize a seção "FocusNFe". 2. Clique em Conectar. 3. No campo Token Principal, cole o código que você acabou de copiar do painel da FocusNFe. 4. Preencha os demais campos do formulário (como alíquotas e códigos de serviço) conforme as regras tributárias da sua cidade. - Dica: Como as exigências fiscais mudam de acordo com cada prefeitura, peça auxílio ao seu contador para preencher esses dados. Informações específicas de cada cidade também podem ser consultadas no Guia de Municípios da FocusNFe. 5. Clique em Salvar. Como Testar a Emissão Antes de colocar a automação em produção para todos os clientes, realize um teste controlado: 1. Crie uma venda manual no painel da mymento no valor de R$ 1,00, preenchendo obrigatoriamente o seu nome e o seu CPF. 2. Finalize a venda (mude o status para finalizado), pois é este movimento que dispara a nota fiscal. 3. Verifique os logs da mymento: Acesse o menu de monitoramento em Configurações > Logs do Sistema (FocusNFe). Se houver algum erro de comunicação listado ali, acione a equipe de suporte da mymento. 4. Verifique o painel da FocusNFe: Se nenhum erro apareceu no log da mymento, acesse o painel da FocusNFe em Painel da API > Requisições e clique em Pesquisar. - Se a nota aparecer com o status de "Erro", envie um e-mail para o suporte deles em suporte@focusnfe.com.br para entender qual regra fiscal da prefeitura rejeitou o documento. - Se a nota aparecer como "Autorizada", a integração está funcionando perfeitamente. 5. Confira na Venda: Retorne à venda de teste dentro da mymento e verifique se o link direto para a NFS-e emitida já está disponível nos detalhes do pedido. ⚠️ Regras Importantes e Detalhes Fiscais - Dados Obrigatórios: A grande maioria dos municípios brasileiros exige o CPF do tomador de serviço para autorizar uma NFS-e, e vários deles exigem também o endereço completo. Certifique-se de deixar esses campos como obrigatórios no formulário de cadastro das suas atividades na mymento. - E-mail de Envio: Caso o cliente não informe um e-mail próprio durante a reserva, o sistema utilizará o e-mail padrão da sua própria conta mymento para preencher o campo do tomador na nota fiscal.