Como integrar o Sagicor eCommerce (MPGS) na Jamaica

Para integrar o Sagicor eCommerce na Jamaica, primeiro obtenha junto ao Sagicor Bank a aprovação para uso do gateway de pagamento para lojistas. Confirme se a conta aprovada oferece suporte ao MPGS Direct ou ao MPGS Hosted Checkout, crie as credenciais de API necessárias no portal de lojistas Mastercard, configure a opção correspondente do Sagicor MPGS no Genius Checkout, teste todo o ciclo de pagamento e, em seguida, repita a configuração usando as credenciais de produção.

Todas as configurações devem refletir exatamente a conta aprovada pelo Sagicor para o seu negócio. Ter acesso ao portal não significa, necessariamente, que o acesso via Direct API, Hosted Checkout, tokenização, pagamentos recorrentes, reembolsos ou suporte a todas as moedas estão liberados para a conta.

Última revisão: 25 de setembro de 2026.

#O papel de cada empresa

O Sagicor descreve sua Payment Gateway Solution como uma forma das empresas processarem pagamentos online. Aprovação, preços, prazos, aceitação de cartões e critérios de risco seguem as diretrizes do contrato comercial vigente com o banco.

#1. Solicite o tipo correto de conta comerciante Sagicor

Antes de pedir as credenciais técnicas, comunique ao banco como o seu negócio irá receber pagamentos. Um hotel que recebe depósitos, uma loja online que envia produtos e um negócio de assinatura recorrente exigem habilitações diferentes.

Solicite ao Sagicor que confirme por escrito:

• Razão social e o Merchant ID concedidos.
• Se a conta opera por MPGS Direct, Hosted Checkout ou ambos.
• URLs do portal administrativo para ambiente de testes e produção.
• Moedas e bandeiras de cartão liberadas.
• Se o 3-D Secure está ativo e obrigatório.
• Se PURCHASE é permitida para captura imediata.
• Se AUTHORIZE e posterior CAPTURE são permitidas.
• Habilitação de estornos totais, parciais e cancelamentos.
• Se a tokenização e pagamentos recorrentes iniciados pelo lojista são permitidos.
• Conta bancária de liquidação e as moedas para recebimento.

Não escolha Direct ou Hosted Checkout apenas com base em uma captura de tela ou nas configurações de outro lojista. Use sempre o material de onboarding fornecido para o seu próprio Merchant ID.

#2. Escolha entre MPGS Direct ou Hosted Checkout

Ambos aceitam pagamentos com cartão online, mas diferem na experiência do checkout e nos requisitos de conta.

Se o negócio venderá assinaturas ou começará com teste grátis e cobrará depois, defina a questão da tokenização antes de criar o site. Um pagamento único aprovado não garante que a conta poderá armazenar métodos de pagamento para uso futuro.

#3. Gere a senha de API do MPGS

O portal administrativo do MPGS no Sagicor geralmente é acessado em sagicorbank.gateway.mastercard.com/ma. Use o endereço informado no e-mail de boas-vindas caso seja diferente.

A senha do portal e a senha da API são credenciais distintas. Para preparar a autenticação via API:

1. Acesse com o administrador de loja fornecido pelo banco.
2. Vá em Admin → Operators e crie um operador, caso não haja um para integração.
3. Faça login como o operador criado/escolhido.
4. Navegue até Admin → Integration Settings → Edit.
5. Gere e habilite Password 1 para acesso à API.
6. Armazene a senha com segurança em um gerenciador de senhas. Não envie por e-mail, print ou versionamento de código.

O Genius Checkout gera o usuário para API MPGS como merchant.<Merchant ID>. Informe apenas o Merchant ID no campo de configuração, sem adicionar o prefixo merchant., a menos que o campo específicamente solicite.

#4. Configure o Sagicor MPGS no Genius Checkout

Inicie em modo de testes, evitando impacto em pedidos reais por erro de configuração.

1. Faça login na conta Genius Checkout que será responsável pelos pagamentos.
2. Acesse o menu Gateways.
3. Escolha MPGS Direct ou MPGS Hosted Checkout conforme a aprovação do banco.
4. Selecione o preset de região Sagicor, quando disponível.
5. Use https://sagicorbank.gateway.mastercard.com como gateway base URL, exceto se o banco informar outro endereço.
6. Informe o Merchant ID e a senha de API do mesmo ambiente (testes ou produção).
7. Mantenha a versão da API conforme padrão documentado, exceto se outro for especificado pelo time de onboarding.
8. Habilite somente moedas confirmadas para esta conta comerciante.
9. Escolha Authorize & Capture para cobrança imediata ou Authorize Only somente quando houver aprovação e processo adequado para capturar depois.
10. Salve a configuração e clique em Test connection.

O teste de conexão autentica e cria uma sessão vazia no MPGS, sem cobrar cartão. Ou seja, se passar, comprova que o host e as credenciais funcionam, mas não garante que pagamento completo, 3-D Secure, captura ou reembolso irão funcionar.

Leia o guia completo de configuração do MPGS ao preencher os campos.

#5. Conecte os sistemas que o negócio já utiliza

Com o MPGS ativo no Genius Checkout, o lojista pode aceitar pagamentos pelo canal mais conveniente:

• Criar links de pagamento e QR Codes para faturas, vendas via WhatsApp, depósitos ou pagamentos presenciais.
• Conectar no WooCommerce para loja WordPress.
• Integrar com HighLevel para funis, agências, assinaturas e vendas por CRM.
• Conectar com Ecwid ou GiveWP conforme a plataforma utilizada pelo negócio.
• Usar a API do Genius Checkout para site ou aplicação customizada e suportada.

Para WordPress, siga o guia específico sobre integração MPGS e WooCommerce. Esse artigo cobre a configuração do plugin, autorização de domínio, notas de pedido, recorrência, cancelamento e reembolsos, sem repetir o passo a passo do onboarding bancário.

#6. Teste mais de um pagamento aprovado

Se prepare para lançar cobrindo os fluxos com que o lojista precisará lidar após o site ao ar.

Anote o ID do pedido teste, o ID da transação Genius Checkout, referência da MPGS, horário UTC, modo e resultado. Jamais armazene número completo de cartão ou código de segurança.

#7. Troque de teste para produção sem misturar credenciais

Testes e produção exigem configurações separadas. Antes de ativar pagamentos reais:

1. Confirme que o Sagicor ativou o Merchant ID de produção e as funções necessárias.
2. Informe o Merchant ID e senha de produção no ambiente de produção do Genius Checkout.
3. Habilite apenas moedas efetivamente aprovadas para produção.
4. Autorize o domínio do site de produção quando requerido.
5. Faça um pagamento real controlado, de baixo valor, com cartão aprovado.
6. Verifique pedido, transação no Genius Checkout, transação no MPGS, recibo, e-mails e registros de liquidação bancária.
7. Teste um estorno ou cancelamento enquanto a equipe de implantação está disponível.

Nunca copie senha de teste para produção, nem assuma que funções liberadas em sandbox estarão ativas automaticamente em produção.

#Problemas comuns ao configurar Sagicor MPGS

#Falha de autenticação

Garanta que Merchant ID, senha da API, base URL e ambiente batem. Resetar a senha do portal não cria nova senha de API.

#Hosted Checkout não abre

Confirme se Hosted Checkout está ativo no perfil de sua conta e se a página está abrindo fora de iframes, pois o gateway pode bloquear esses casos.

#Pagamento unitário aprova, mas assinaturas falham

A conta pode aceitar compras simples mas não liberar tokenização ou pagamentos recorrentes. Cheque a liberação no banco e a função no Genius Checkout.

#Moeda recusada

A moeda do site, do gateway Genius Checkout e liberada pelo Sagicor precisam coincidir. A disponibilidade de moeda no software não garante habilitação na conta comerciante.

#Cliente retorna sem atualizar o pedido

Verifique entrega do callback do gateway, return URL, webhook e status final do MPGS. Não marque pedido como pago só por redirecionamento de navegador.

#Perguntas frequentes

#Sagicor eCommerce é igual ao MPGS?

Sagicor fornece o relacionamento e a solução de gateway ao lojista aprovado. A integração usa o gateway tecnológico MPGS da Mastercard. O lojista deve seguir as etapas do Sagicor e usar as credenciais emitidas para seu perfil no banco.

#Preciso ter conta pessoa jurídica no Sagicor?

Os requisitos de conta e liquidação são definidos pelo Sagicor. Consulte o banco sobre qual conta comercial, documentos e contrato de lojista abrangem sua empresa.

#Posso usar MPGS sem WooCommerce?

Sim. O Genius Checkout permite configurar o MPGS aprovado para links de pagamento, QR Codes, integrações com softwares compatíveis e projetos customizados via API. A melhor opção depende do processo do seu negócio, não apenas do gateway em si.

#O Genius Checkout aprova cadastro de lojista?

Não. A aprovação do lojista, liquidação, taxas e recursos do gateway são controlados pelo Sagicor. O Genius Checkout cuida apenas da conexão técnica após a aprovação do banco.

#Referências oficiais e próximos passos

• Sagicor Payment Gateway Solutions
• Formas de pagamento empresas Sagicor
• Documentação API Mastercard Hosted Checkout
• Visão geral do MPGS no Genius Checkout
• Guia de configuração MPGS Genius Checkout

Crie uma conta Genius Checkout ou agende uma avaliação de integração com os dados do seu onboarding Sagicor à mão.