Como conectar a HyperPay à minha loja?
A HyperPay permite que clientes na Arábia Saudita paguem online com mada, Visa, Mastercard, Apple Pay e STC Pay em uma página de pagamento segura. Cada conta HyperPay funciona em uma moeda (SAR, AED, QAR, EGP ou USD) e só aparece no checkout quando seus preços estão nessa moeda.
Passos
- Obtenha suas credenciais com a HyperPay: um access token e um entity ID por grupo de pagamento (Visa / Mastercard, mada e, se ativados, Apple Pay e STC Pay).
- Na Dropify, vá em Aplicativos → Explorar, encontre HyperPay e clique em Instalar.
- Na página do aplicativo, clique em Conectar HyperPay (ou em Adicionar conta), informe um Nome da conta, cole o Access token e o Entity ID (Visa / Mastercard), adicione os entity IDs opcionais de mada, Apple Pay e STC Pay, escolha a Moeda da conta (SAR para contas sauditas) e salve. A Dropify verifica cada entity com a HyperPay.
- No cartão Configurações, escolha Modo Sandbox com credenciais de teste ou Modo Produção com as de produção.
- Recomendado: clique em Copiar URL do webhook, adicione-a no painel da HyperPay e cole a chave de descriptografia dele em Segredo do webhook.
- Vá em Configurações da loja → Formas de pagamento e ative HyperPay. Opcional: defina um Desconto para pedidos pré-pagos.
- Faça um pedido de teste: o cliente escolhe mada, cartão, Apple Pay ou STC Pay, depois paga.
Somente os métodos para os quais você informou um entity ID são oferecidos aos clientes.
Problemas comuns
- "A HyperPay recusou estas chaves no modo de teste" → o token ou um dos entity IDs pertence ao outro ambiente. Use credenciais de teste no Modo Sandbox.
- O mada não aparece na página de pagamento → adicione o Entity ID (mada, opcional); o mada sempre tem seu próprio entity.
- A HyperPay não aparece no checkout → a moeda da sua loja é diferente da Moeda da conta, a conta está com o status Inativo, ou a HyperPay está desativada em Formas de pagamento.
- Os pedidos continuam sem pagamento quando o cliente fecha a página → adicione o webhook (passo 5).
Relacionados
- available payment gateways by country
- Como conectar a Moyasar à minha loja?
- Como conectar a Geidea à minha loja?