💳 Como configurar e conectar a conta do Cliente Solicitante.
Tempo estimado de leitura: 6 minutos
A integração entre a MaisEntregas e a SumUp permite que os Entregadores realizem cobranças diretamente pela maquininha durante as entregas.
O fluxo possui duas etapas de configuração:
- Configuração da integração pela transportadora, com a criação das credenciais necessárias para comunicação entre MaisEntregas e SumUp;
- Autorização da conta SumUp pelo Cliente Solicitante, que conecta sua própria conta à MaisEntregas para receber os valores cobrados pelos Entregadores.
⚠️ Importante: a conta SumUp que receberá os pagamentos deve pertencer ao Cliente Solicitante. Os valores cobrados pelo Entregador serão direcionados para a conta SumUp que o Cliente autorizou na plataforma.
💳 Modelos de maquininhas compatíveis
Os modelos informados como compatíveis com a integração e que possuem tecnologia NFC são:
- SumUp Smart
- SumUp Total
- SumUp Solo Printer
- SumUp Solo
⚙️ ETAPA 1 — Configuração da integração pela Transportadora
Antes que os Clientes Solicitantes possam conectar suas contas SumUp, é necessário realizar a configuração inicial da integração.
1. Solicite a ativação da integração
Entre em contato com o Suporte MaisEntregas e solicite:
- A ativação da integração SumUp;
- O nome do pacote do Aplicativo do Entregador da sua plataforma.
Guarde o nome do pacote, pois ele será utilizado na configuração da Affiliate Key.
🔑 2. Gere a Affiliate Key
Acesse o portal de desenvolvedores da SumUp e faça login na conta utilizada para realizar a configuração.
2.1. Acesse
Account → Affiliate Key
2.2. Configure o Application ID
No campo Application ID, informe exatamente o nome do pacote do Aplicativo do Entregador fornecido pela MaisEntregas.
Depois, atualize a página.
2.3. Copie a Affiliate Key
Após atualizar a página, copie a Affiliate Key gerada.
📌 Guarde essa chave. Ela deverá ser enviada para a MaisEntregas ao final da configuração.
🔐 3. Crie a aplicação OAuth
No portal de desenvolvedores da SumUp, acesse:
Account → OAuth2 Apps → Create application
Preencha:
| Campo | Preenchimento |
|---|---|
| Application name | Aplicativo Entregador - Nome da Transportadora |
| Homepage URL | https://NOME_TRANSPORTADORA.maisentregas.com |
Substitua NOME_TRANSPORTADORA pelo identificador utilizado na URL da sua plataforma.
📌 Exemplo
Se o endereço da plataforma for:
https://minhaempresa.maisentregas.com
Utilize esse endereço no campo Homepage URL.
🔓 4. Habilite as permissões
Após registrar a aplicação, habilite as permissões necessárias para a integração no portal da SumUp.
⚠️ Caso alguma permissão necessária não possa ser selecionada, solicite a liberação ao suporte da SumUp.
E-mail: digitalpayments@sumup.com
🗝️ 5. Crie o Client Secret
Na aplicação criada, localize:
Create client secret
Preencha:
| Campo | Preenchimento |
|---|---|
| Client name | NOME_TRANSPORTADORA.maisentregas.com |
| Type | Web |
| URL | https://NOME_TRANSPORTADORA.maisentregas.com/sumup/oauthCallback |
📌 Exemplo
Para:
https://minhaempresa.maisentregas.com
Utilize:
https://minhaempresa.maisentregas.com/sumup/oauthCallback
Depois:
- Salve a configuração;
- Abra o Client Secret criado;
- Faça o download do arquivo;
- Guarde o arquivo para encaminhá-lo à MaisEntregas.
🔐 Importante: o Client Secret é uma credencial de integração. Não compartilhe esse arquivo publicamente. Envie-o somente pelo canal solicitado pela equipe responsável.
📤 6. Envie as informações para a MaisEntregas
Ao finalizar a configuração, encaminhe para a equipe MaisEntregas:
- Affiliate Key;
- Arquivo do Client Secret.
Com essas informações, a equipe poderá concluir a configuração necessária na plataforma.
🚨 Antes de utilizar a integração em produção
Antes de começar a realizar cobranças, a transportadora deve informar à SumUp que as maquininhas serão utilizadas para realizar cobranças em nome de diferentes Clientes Solicitantes.
Essa comunicação é necessária para evitar possíveis bloqueios da conta ou dos dispositivos.
👤 ETAPA 2 — Conectar a conta SumUp do Cliente Solicitante
Após a configuração inicial da integração, cada Cliente Solicitante que utilizará a funcionalidade deverá autorizar sua própria conta SumUp.
É essa conta que receberá os valores das cobranças realizadas pelos Entregadores.
🔗 7. Acesse o menu SumUp
No ambiente do Cliente Solicitante, acesse:
SumUp
Em seguida, clique em:
Autorizar App Entregador na SumUp
A plataforma iniciará o processo de autorização da conta.
🔐 8. Faça login na conta SumUp
Será aberta uma página da SumUp.
Faça login utilizando as credenciais da conta SumUp do Cliente Solicitante que deverá receber os pagamentos.
Em seguida, realize a autorização solicitada.
⚠️ Atenção: certifique-se de realizar o login na conta SumUp correta. É nessa conta que serão recebidos os valores cobrados durante as entregas.
✅ 9. Confirme a integração
Após realizar a autorização, retorne ao menu:
SumUp
Quando a conexão estiver concluída, será apresentada a informação:
Token de acesso está configurado.
Isso indica que a conta SumUp do Cliente Solicitante está conectada à MaisEntregas.
💰 10. Como funciona o recebimento
Com a integração configurada:
- Uma corrida (OS) é criada com o Valor do Produto que deverá ser cobrado;
- O Entregador realiza a entrega;
- A cobrança é realizada utilizando a maquininha SumUp compatível;
- O pagamento é direcionado para a conta SumUp integrada do Cliente Solicitante.
Dessa forma, o Entregador utiliza a maquininha durante a operação, enquanto o recebimento fica vinculado à conta SumUp autorizada pelo Cliente Solicitante.
📌 Resumo da configuração
Transportadora: realiza a configuração inicial da integração, obtém a Affiliate Key e o Client Secret e encaminha as informações para a MaisEntregas.
Cliente Solicitante: acessa SumUp → Autorizar App Entregador na SumUp e conecta a conta SumUp que receberá seus pagamentos.
Entregador: utiliza a maquininha SumUp compatível para realizar a cobrança durante a entrega.
Pagamento: é direcionado para a conta SumUp integrada do Cliente Solicitante.
🔎 Palavras-chave para busca e IA Maia
SumUp, integração SumUp, configurar SumUp, integrar conta SumUp, conectar SumUp, autorizar SumUp, Autorizar App Entregador na SumUp, SumUp MaisEntregas, Cliente Solicitante SumUp, conta SumUp Cliente Solicitante, receber pagamento SumUp, pagamento SumUp, maquininha SumUp, maquininha entregador, cobrança pelo entregador, cobrança na entrega, pagamento na entrega, Valor do Produto, Affiliate Key, gerar Affiliate Key, Application ID, OAuth, OAuth2, OAuth2 Apps, Client Secret, criar Client Secret, token SumUp, token de acesso SumUp, pacote Aplicativo Entregador, nome do pacote, NFC, SumUp Smart, SumUp Solo, SumUp Total, SumUp Solo Printer, oauthCallback, configurar maquininha, erro integração SumUp, App Entregador, MaisEntregas