Como ligar o seu software a um gateway de pagamento na Arábia Saudita: Moyasar, Tap ou HyperPay

Ligar o seu software ou loja online a um gateway de pagamento na Arábia Saudita faz-se em sete passos: abrir uma conta de comerciante com registo comercial ou licença de trabalhador independente e uma conta bancária saudita, obter as chaves de teste, escolher o método de integração (um plugin pronto, um formulário de pagamento alojado ou uma API direta), enviar os montantes em halalas, confirmar cada pagamento a partir do seu servidor e não do navegador, testar com cartões de teste e passar para as chaves reais. Moyasar, Tap e HyperPay aceitam todas mada e Apple Pay; diferem nos meios de pagamento extra, nos países, nas ferramentas para programadores e na rapidez com que o dinheiro chega. Nem a Moyasar nem a HyperPay publicam um preço fixo; a equipa comercial define-o pelo seu volume.

Primeiro: confirme que o gateway tem licença da SAMA

O Banco Central da Arábia Saudita licencia os prestadores de serviços de pagamento ao abrigo do Regulamento de Execução da Lei de Pagamentos e Serviços de Pagamento, publicado a 13 de junho de 2023. Segundo o anúncio da SAMA de 22 de julho de 2026, 33 empresas tinham licença para prestar serviços de pagamento. Os três gateways deste guia têm licença:

• Moyasar: licenciada pela SAMA a 1 de março de 2022 para serviços de pagamento de comércio eletrónico, como a 16.ª empresa licenciada (anúncio da SAMA).
• HyperPay: a empresa diz que a SAMA lhe concedeu uma licença para soluções de carteira eletrónica, elevando então o número de empresas licenciadas para 27 (anúncio da HyperPay).
• Tap: o comunicado da empresa diz que tem uma licença de instituição de pagamento da SAMA e que a mada certificou a tecnologia do seu gateway (comunicado da Tap).

Seja qual for o gateway escolhido, procure o nome no site da SAMA antes de assinar, porque o próprio banco central pede às empresas que trabalhem apenas com prestadores licenciados.

Comparação completa: Moyasar, Tap e HyperPay

Montámos esta comparação a partir das páginas oficiais e da documentação para programadores de cada empresa, tal como estavam a 2 de novembro de 2026:

Fontes: perguntas frequentes da Moyasar e documentação da Moyasar, documentação para programadores da Tap e página de liquidações do suporte da Tap, site da HyperPay, as suas perguntas frequentes e o seu guia de integração.

Que gateway serve o seu software?

• Vende só na Arábia Saudita e quer começar depressa: a Moyasar foca-se na Arábia Saudita, tem documentação em árabe e inglês, e o seu formulário de pagamento funciona com poucas linhas de código.
• Vende no Golfo ou quer pagamentos em prestações: a documentação da Tap cobre a KNET e a Benefit, e também a Tabby, a Tamara e a Deema no mesmo gateway.
• Uma grande empresa ou uma que opera em vários países árabes: a HyperPay está em 8 países e oferece pré-autorização mada, útil para hotéis e aluguer de automóveis quando cativa um valor e o cobra mais tarde.
• Uma plataforma ou marketplace com muitos vendedores: as três oferecem uma ferramenta para repartir fundos entre vendedores, por isso compare-as no mesmo orçamento.

Não escolha só pelo preço. Peça a cada empresa, por escrito, a taxa mada, a taxa dos cartões de crédito, a tarifa fixa por transação, as tarifas de reembolso e o prazo de liquidação, e aplique-os a um mês real das suas vendas.

Guia de integração passo a passo

1. Abra uma conta de comerciante. A Moyasar pede um registo comercial ou uma licença de independente e uma conta bancária saudita associada, e analisa a própria loja: produtos, imagens, preços e políticas. A aprovação demora normalmente de 2 a 5 dias úteis depois de entregues todos os documentos.
2. Obtenha as chaves de teste. Os três dão-lhe um ambiente de testes. Na Tap, as chaves estão no painel, em API credentials, e as apps móveis recebem chaves próprias ligadas ao bundle ID do iOS ou ao package ID do Android. Guarde a chave secreta só no servidor, nunca dentro da app nem da página web.
3. Escolha o método de integração. Se a sua loja usa WooCommerce ou Magento, o plugin pronto é o caminho mais rápido. Para software à medida, comece por um formulário de pagamento alojado: o formulário da Moyasar ou o COPYandPAY da HyperPay. Estes formulários enviam os dados do cartão diretamente para o gateway, que nunca passam pelo seu servidor, e o seu esforço com o PCI DSS diminui. Uma integração direta servidor a servidor dá mais controlo, mas também mais responsabilidade de segurança.
4. Envie os montantes em halalas. Na Moyasar, 10 SAR escrevem-se 1000, e o mínimo é de 100 halalas. Um erro neste campo faz o cliente pagar cem vezes mais ou um centésimo do preço.
5. Confirme o pagamento a partir do servidor. Não marque uma encomenda como paga só porque o cliente chegou à página de sucesso; esse endereço pode ser falsificado. Consulte o estado do pagamento a partir do servidor e receba o webhook. A documentação da HyperPay avisa que, em casos raros, os webhooks podem atrasar vários minutos, por isso consulte o estado diretamente quando precisar dele em tempo real. Associe cada tentativa de pagamento a um único número de encomenda para que uma nova tentativa não cobre o cliente duas vezes. Na HyperPay, uma sessão de pagamento expira no máximo ao fim de 30 minutos.
6. Teste a falha antes do sucesso. Os cartões de teste da Moyasar incluem 8 cartões mada: um é aprovado e 7 falham por motivos diferentes, como saldo insuficiente, cartão expirado ou roubado. Confirme que o seu software mostra uma mensagem clara em cada caso, liberta a reserva ou repõe o artigo em stock, e depois teste reembolsos totais e parciais.
7. Passe para produção. Troque as chaves, faça você mesmo um pagamento real pequeno, reembolse-o e acompanhe a primeira semana: a taxa de sucesso e quando o dinheiro chegou à sua conta.

Erros que lhe custam dinheiro

• Guardar dados de cartão na sua base de dados. Não precisa deles; o gateway guarda um token por si se quiser pagamentos recorrentes.
• Esperar o dinheiro no próprio dia. Na Tap, os valores mada chegam em 3 dias úteis e os de cartões em 5, por isso planeie a tesouraria em função disso.
• Esquecer o circuito de reembolso. Na Moyasar, o cliente espera de 7 a 14 dias úteis por um reembolso no cartão de crédito; avise-o, ou ele pode abrir uma disputa com o banco.
• Uma página de pagamento longa. Cada campo a mais faz perder um comprador; o nosso guia da página de pagamento mostra como reduzir o abandono do carrinho.

Se quiser primeiro o básico, leia como integrar mada, Apple Pay e STC Pay na sua app. Se tem uma loja física e pensa receber pagamentos com o telemóvel, leia o que sabemos sobre o Tap to Pay na Arábia Saudita. Na Origami ligamos o software e as lojas das empresas a gateways de pagamento e testamos a integração antes do lançamento; fale connosco se quiser que tratemos disso.

Fontes

• Banco Central da Arábia Saudita: 33 empresas de pagamento licenciadas, 22 de julho de 2026
• Banco Central da Arábia Saudita: licença da Moyasar Financial Company, 1 de março de 2022
• Banco Central da Arábia Saudita: Regulamento de Execução da Lei de Pagamentos e Serviços de Pagamento
• HyperPay: a SAMA licencia a empresa para soluções de carteira eletrónica
• Tap: certificação do gateway de pagamento pela mada
• Moyasar: perguntas frequentes
• Moyasar: integração do formulário de pagamento e cartões de teste
• Tap: guia de início para programadores
• Tap: quando os pagamentos chegam às contas bancárias na Arábia Saudita
• HyperPay: guia de integração, COPYandPAY e webhooks
• HyperPay: perguntas frequentes