Como integrar o Powertranz na Jamaica

Para integrar o Powertranz na Jamaica, comece obtendo uma credencial de e-commerce junto a um banco ou adquirente que suporte o Powertranz, confirme se a conta utiliza o Powertranz Direct ou o Hosted Payment Page (HPP), configure as credenciais de teste correspondentes no Genius Checkout, conecte o site ou plataforma de vendas, realize testes completos do ciclo de pagamento e então ative a configuração definitiva no ambiente de produção.

O Powertranz foi anteriormente conhecido como First Atlantic Commerce ou FAC. Formulários, e-mails de credenciais e portais dos bancos podem ainda mencionar o nome FAC, mas eles se referem à mesma família de gateways. O Powertranz anunciou a troca de marca em maio de 2025.

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

#Quais bancos jamaicanos conectam empresas ao Powertranz?

Na Jamaica, o Genius Checkout atualmente aceita contas de comerciante Powertranz emitidas pelos seguintes bancos:

• National Commercial Bank Jamaica, apresentado como JNCB.
• First Global Bank.
• CIBC Caribbean.
• Scotiabank Jamaica.

Cada instituição precisa aprovar seu negócio e confirmar os produtos disponíveis, moedas habilitadas, condições de liquidação e requisitos de cadastro. Solicite especificamente uma conta de pagamento online com cartão, e-commerce acquiring ou conta Powertranz/FAC.

Confirme o processador do produto aprovado antes de inserir qualquer credencial. Um banco pode oferecer mais de um serviço de pagamento, e credenciais de outro gateway não são compatíveis com as do Powertranz.

A página de eCommerce da NCB é um exemplo: a NCB oferece uma página de pagamento hospedada pelo Powertranz, anteriormente FAC. Outro banco pode fornecer o processamento Direct, HPP ou um pacote comercial distinto. O Genius Checkout não substitui o contrato de adquirência. Ele faz a interface entre a credencial aprovada e as ferramentas de vendas do seu negócio.

#Comece pelo modelo de negócio, não pelo formulário de credencial

O banco vai analisar o que sua empresa vende, como o cliente recebe, valores médios das transações, riscos de estorno, moedas utilizadas e controles antifraude. Apresente uma descrição clara das operações antes de solicitar.

Exemplos:

• Um hotel pode precisar de cobranças de depósito, saldo, cancelamento e aceitar USD e JMD.
• Um clube de assinaturas pode precisar de pagamento recorrente e tokenização.
• Um varejista pode exigir captura imediata, estorno parcial e prova de entrega.
• Consultores podem precisar apenas de links de pagamento para faturas e adiantamentos.
• Organizadores de eventos podem precisar de checkout via QR code e política de reembolso eficiente.

Solicite ao banco ou equipe de integração confirmação sobre:

• IDs de Comerciante (Merchant ID) de teste e produção.
• Senhas de processamento para teste e produção.
• Moedas e contas de crédito habilitadas.
• Direct, HPP, ou ambos.
• Requisitos de 3-D Secure.
• Capacidade SALE (captura imediata).
• Capacidades de AUTHORIZE, posterior CAPTURE, cancelamento, reembolso total e parcial.
• Permissão para tokenização e pagamentos recorrentes.
• Para HPP, os campos exatos PageSet e PageName.
• Se o perfil do portal aparece como FAC ou Powertranz.

A senha de acesso ao portal não é necessariamente a senha de processamento. Não reutilize apenas porque os nomes são parecidos.

#Escolha entre Powertranz Direct ou HPP

O melhor modo depende da conta aprovada e da experiência desejada para o cliente.

O Powertranz descreve o Hosted Payment Page como um redirecionamento a uma página segura. Isso faz diferença para plataformas que usam iframe: a integração inicial pode ser embutida, mas a página externa hospedada normalmente precisa abrir em tela cheia no navegador.

#Configure Powertranz no Genius Checkout

Faça a configuração primeiro no modo de teste.

1. Acesse a conta Genius Checkout que receberá os pagamentos.
2. Entre em Gateways.
3. Escolha Powertranz Direct ou Powertranz HPP conforme o kit de onboarding.
4. Insira o Merchant ID e senha de teste.
5. Para HPP, digite PageSet e PageName exatamente como recebidos e selecione o tipo de portal (FAC ou Powertranz).
6. Habilite apenas as moedas aprovadas para a conta.
7. No Direct, selecione Autorizar & Capturar para cobrança imediata, ou Somente Autorizar se o modelo de negócio prevê captura posterior.
8. Habilite 3-D Secure, verificação de endereço ou tokenização apenas quando forem suportados pela conta e necessários para sua operação.
9. Salve e resolva todas as validações.
10. Faça o teste de conexão e uma transação controlada.

O Genius Checkout usa o endpoint de testes do Powertranz no modo sandbox e o endpoint de produção no modo real. Certifique-se de que Merchant ID, senha, moeda, ambiente e API key do site estejam alinhados. Um erro comum ocorre quando se mistura um dado de produção em uma configuração de teste.

O guia de configuração do Powertranz detalha todos os campos e suas origens.

#Conecte Powertranz à forma de venda do seu negócio

Após validar o gateway, escolha o canal que resolve o problema do seu cliente:

• Use links de pagamento e QR codes para faturas, adiantamentos, vendas por WhatsApp ou pagamentos presenciais.
• Conecte WooCommerce a um e-commerce WordPress.
• Integre HighLevel para funis, automações de CRM, agências e clubes de assinatura.
• Use Ecwid ou GiveWP quando esses sistemas forem adequados ao seu modelo.
• Recorra à API do Genius Checkout para aplicações customizadas aprovadas.

Lojas WordPress podem seguir o guia separado Powertranz e WooCommerce. Usuários HighLevel devem seguir o guia Powertranz e HighLevel. Estes guias abordam a configuração específica da plataforma, enquanto este artigo trata do onboarding para a Jamaica de maneira geral.

#Um teste antes do lançamento na Jamaica que vale a pena executar

Não encerre o teste após apenas uma tela de aprovação. Valide o fluxo desde o clique inicial até o registro de conciliação do comerciante.

#Dados do cliente e do pedido

• Nome da empresa, contato de suporte, valor e moeda corretos.
• Nome, e-mail, telefone e endereço de cobrança conforme informados pelo comprador.
• Cada tentativa gera uma transação única no Genius Checkout e referência de pedido no gateway.
• Uma nova tentativa não sobrepõe uma transação financeira anterior com falha.

#Estados de pagamento

• Pagamento com cartão aprovado.
• Recusa segura com mensagem clara.
• Desafio 3-D Secure e retorno do cliente.
• Cancelamento da compra e ação de retorno do navegador.
• Redirecionamento para topo em HPP quando necessário.
• Comunicação duplicada de callback sem cobrança duplicada.
• Autorizar, capturar, cancelar, reembolsar total e parcialmente conforme aprovado.

#Uso recorrente

• Salvar método de pagamento apenas com consentimento do cliente.
• Confirmar que o token retornado pertence ao comerciante e cliente corretos.
• Testar configuração de teste gratuito (zero valor) se o site vender assinaturas de teste.
• Realizar a primeira renovação paga.
• Simular falha de renovação e retentativa manual.
• Garantir que cada retentativa use novo identificador de pedido no gateway.

Utilize cartões de teste aprovados pelo provedor. Para a validação final, realize uma transação real de baixo valor, controlada pela equipe de testes. Não teste no e-mail ou pedido de cliente real.

#Migre para produção com segurança

1. Confirme com o banco ou Powertranz a ativação do perfil definitivo.
2. Insira o Merchant ID, senha e campos HPP de produção no ambiente "live" do Genius Checkout.
3. Verifique moedas habilitadas e ação de pagamento.
4. Autorize o domínio do site de produção, se necessário.
5. Realize um pagamento real de baixo valor.
6. Compare pedido no site, transação no Genius Checkout, registro do Powertranz, recibo e conciliação.
7. Teste o fluxo de cancelamento ou reembolso aprovado.
8. Documente quem ficará responsável por monitorar recusas, disputas, reembolsos e conciliação após o lançamento.

Mantenha credenciais de teste e produção completamente separadas, mesmo que os Merchant IDs sejam parecidos.

#Problemas comuns de integração Powertranz

#“Nenhum gateway de pagamento configurado”

A API key do site pode estar vinculada a outro ambiente ou conta Genius Checkout. Confira o comerciante exibido na integração antes de ajustar os dados do gateway.

#“ID de pedido duplicado não permitido”

Cada tentativa de pagamento, renovação, ou retentativa precisa de um identificador novo perante o gateway. Use o número do pedido apenas como metadado. Não o reutilize como ID financeiro único.

#HPP não abre janela de pagamento

O navegador pode estar bloqueando pop-up ou o fluxo pode estar tentando abrir um checkout de topo dentro de um iframe. O redirecionamento padrão deve levar o cliente diretamente à página hospedada. Plataformas embutidas requerem passagem deliberada para nível superior.

#Pagamento avulso aprova, mas renovação falha

Confira se o recurso de tokenização, Card-on-File, permissão de cobrança recorrente, plano e validade do token estão habilitados. O sucesso no HPP não garante que a tokenização está disponível no Direct.

#Dados do comprador contêm valores não informados

Não invente endereços só para preencher campo opcional. Transmita apenas informações efetivamente fornecidas, normalize caracteres especiais de modo conservador e registre o que foi enviado sem armazenar dados sensíveis do cartão.

#Perguntas frequentes

#FAC é o mesmo que Powertranz?

Powertranz é a marca atual do gateway anteriormente chamado de First Atlantic Commerce. Documentos antigos e integrações bancárias podem ainda usar o rótulo FAC.

#Solicito minha credencial no Genius Checkout ou no banco?

Solicite sua credencial junto a um banco ou adquirente compatível. O Genius Checkout conecta sua conta Powertranz aprovada às plataformas, links de pagamento e APIs disponíveis.

#Posso receber pagamentos em conta bancária jamaicana?

A liquidação depende do contrato com o banco ou adquirente. Confirme tipo de conta, moedas, taxas, reservas e prazos com a instituição antes do lançamento.

#Powertranz funciona só com WooCommerce?

Não. O mesmo gateway aprovado pode ser acessado por várias integrações e canais do Genius Checkout. Cada plataforma exige configuração, testes de retorno, webhook, retentativa e controle do status do pedido.

#Referências oficiais e próximos passos

• Locais e instituições participantes Powertranz
• Gateway de pagamento Powertranz
• Powertranz Hosted Payment Page
• NCB eCommerce
• Visão geral do Powertranz no Genius Checkout
• Guia de configuração Powertranz no Genius Checkout

Crie sua conta Genius Checkout ou agende uma revisão de setup com o kit do banco disponível.