# 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

1. 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).
2. Na Dropify, vá em **Aplicativos → Explorar**, encontre **HyperPay** e clique em **Instalar**.
3. 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.
4. No cartão **Configurações**, escolha **Modo Sandbox** com credenciais de teste ou **Modo Produção** com as de produção.
5. Recomendado: clique em **Copiar URL do webhook**, adicione-a no painel da HyperPay e cole a chave de descriptografia dele em **Segredo do webhook**.
6. Vá em **Configurações da loja → Formas de pagamento** e ative **HyperPay**. Opcional: defina um **Desconto para pedidos pré-pagos**.
7. 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?](https://help.dropify.shop/pt/payments_gateways/moyasar/)
- [Como conectar a Geidea à minha loja?](https://help.dropify.shop/pt/payments_gateways/geidea/)
