A integração com a SumUp permite que o Entregador cobre o pagamento pela maquininha durante a entrega, e que o valor seja recebido na conta SumUp do Cliente Solicitante.
⚠️ Importante: a conta SumUp que receberá os pagamentos deve pertencer ao Cliente Solicitante. Os valores cobrados pelo Entregador vão para a conta SumUp que o Cliente autorizou na plataforma.
Maquininhas compatíveis
Os modelos compatíveis com a integração, que possuem tecnologia NFC, são:
- SumUp Smart
- SumUp Total
- SumUp Solo Printer
- SumUp Solo
Visão geral do processo
O processo tem duas etapas:
- Configuração da integração pelo administrador da sua operação, com a criação das credenciais de comunicação entre a MaisEntregas e a SumUp.
- Autorização da conta SumUp pelo Cliente Solicitante, que conecta a conta dele à MaisEntregas para receber os valores cobrados.
ETAPA 1 — Configuração da integração pelo administrador
Antes que os Clientes Solicitantes possam conectar suas contas SumUp, é necessário fazer 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: ele será usado na configuração da Affiliate Key.
2. Gere a Affiliate Key
Acesse o portal de desenvolvedores da SumUp e faça login na conta usada para a configuração.
- Acesse Account > Affiliate Key.
- No campo Application ID, informe exatamente o nome do pacote do Aplicativo do Entregador fornecido pela MaisEntregas.
- Atualize a página.
- Copie a Affiliate Key gerada.
📌 Guarde essa chave. Ela deverá ser enviada à MaisEntregas ao final da configuração.
3. Crie a aplicação OAuth
No portal de desenvolvedores da SumUp, acesse Account > OAuth2 Apps > Create application e preencha:
| Campo | Preenchimento |
|---|---|
| Application name | Aplicativo Entregador - Nome da sua operação |
| Homepage URL | https://NOME_OPERACAO.maisentregas.com |
Substitua NOME_OPERACAO pelo identificador que aparece na URL da sua plataforma.
Exemplo: se o endereço da plataforma for https://minhaempresa.maisentregas.com, use esse endereço no campo Homepage URL.
4. Habilite as permissões
Depois de registrar a aplicação, habilite as permissões necessárias para a integração no portal da SumUp.
⚠️ Se alguma permissão necessária não puder ser selecionada, solicite a liberação ao suporte da SumUp pelo e-mail digitalpayments@sumup.com.
5. Crie o Client Secret
Na aplicação criada, localize Create client secret e preencha:
| Campo | Preenchimento |
|---|---|
| Client name | NOME_OPERACAO.maisentregas.com |
| Type | Web |
| URL | https://NOME_OPERACAO.maisentregas.com/sumup/oauthCallback |
Exemplo: para https://minhaempresa.maisentregas.com, use 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 indicado pela equipe da MaisEntregas.
6. Envie as informações para a MaisEntregas
Ao final da configuração, encaminhe à equipe da MaisEntregas:
- a Affiliate Key;
- o arquivo do Client Secret.
Com essas informações, a equipe poderá concluir a configuração na plataforma.
Antes de usar a integração em produção
Antes de começar as cobranças, a sua operação deve informar à SumUp que as maquininhas serão usadas para cobrar em nome de diferentes Clientes Solicitantes. Essa comunicação evita possíveis bloqueios da conta ou dos dispositivos.
ETAPA 2 — Conectar a conta SumUp do Cliente Solicitante
Depois da configuração inicial, cada Cliente Solicitante que for usar a funcionalidade deve autorizar a sua própria conta SumUp. É essa conta que recebe os valores das cobranças feitas pelos Entregadores.
7. Acesse o menu SumUp
No ambiente do Cliente Solicitante, acesse o menu SumUp e 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 com as credenciais da conta SumUp do Cliente Solicitante que vai receber os pagamentos e autorize a solicitação.
⚠️ Atenção: confirme que está logado na conta SumUp correta. É nela que serão recebidos os valores cobrados durante as entregas.
9. Confirme a conexão
Depois da autorização, volte ao menu SumUp. Quando a conexão estiver concluída, aparecerá a mensagem Token de acesso está configurado.
Essa mensagem indica que a conta SumUp do Cliente Solicitante está conectada à MaisEntregas.
Como funciona o recebimento
- Uma corrida (OS) é criada com o Valor do Produto a ser cobrado.
- O Entregador realiza a entrega.
- A cobrança é feita com a maquininha SumUp compatível.
- O pagamento é direcionado para a conta SumUp integrada do Cliente Solicitante.
Resumo
- Administrador da sua operação: faz a configuração inicial, obtém a Affiliate Key e o Client Secret e envia ambos à MaisEntregas.
- Cliente Solicitante: acessa SumUp > Autorizar App Entregador na SumUp e conecta a conta que receberá os pagamentos.
- Entregador: usa a maquininha SumUp compatível para cobrar durante a entrega.
- Pagamento: é direcionado para a conta SumUp do Cliente Solicitante.