# Come collego HyperPay al mio negozio?

HyperPay permette ai clienti in Arabia Saudita di pagare online con mada, Visa, Mastercard, Apple Pay e STC Pay su una pagina di pagamento sicura. Ogni account HyperPay funziona in una sola valuta (SAR, AED, QAR, EGP o USD) e compare al checkout solo quando i tuoi prezzi sono in quella valuta.

## Passaggi

1. Richiedi le tue credenziali a HyperPay: un **access token** e un **entity ID** per ogni gruppo di pagamento (Visa / Mastercard, mada e, se attivati, Apple Pay e STC Pay).
2. In Dropify, vai su **App → Esplora**, trova **HyperPay** e clicca su **Installa**.
3. Nella pagina dell'app, clicca su **Collega HyperPay** (oppure su **Aggiungi account**), inserisci un **Nome dell'account**, incolla l'**Access token** e l'**Entity ID (Visa / Mastercard)**, aggiungi gli entity ID facoltativi di mada, Apple Pay e STC Pay, scegli la **Valuta dell'account** (SAR per gli account sauditi) e salva. Dropify verifica ogni entity con HyperPay.
4. Nella scheda **Impostazioni**, scegli **Modalità Sandbox** con le credenziali di test o **Modalità Live** con quelle live.
5. Consigliato: clicca su **Copia URL del webhook**, aggiungilo nella dashboard di HyperPay e incolla la sua chiave di decrittazione in **Secret del webhook**.
6. Vai su **Impostazioni negozio → Metodi di pagamento** e attiva **HyperPay**. Facoltativo: imposta uno **Sconto per ordini prepagati**.
7. Fai un ordine di prova: il cliente sceglie mada, carta, Apple Pay o STC Pay, poi paga.

Ai clienti vengono proposti solo i metodi per cui hai inserito un entity ID.

## Problemi comuni

- "HyperPay ha rifiutato queste chiavi in modalità test" → il token o uno degli entity ID appartiene all'altro ambiente. Usa le credenziali di test in Modalità Sandbox.
- mada manca nella pagina di pagamento → aggiungi l'**Entity ID (mada, facoltativo)**; mada ha sempre una propria entity.
- HyperPay non compare al checkout → la valuta del tuo negozio è diversa dalla **Valuta dell'account**, l'account è Inattivo, oppure HyperPay è disattivato in Metodi di pagamento.
- Gli ordini restano non pagati quando il cliente chiude la pagina → aggiungi il webhook (passaggio 5).

## Correlati

- available payment gateways by country
- [Come collego Moyasar al mio negozio?](https://help.dropify.shop/it/payments_gateways/moyasar/)
- [Come collego Geidea al mio negozio?](https://help.dropify.shop/it/payments_gateways/geidea/)
