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
- 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).
- In Dropify, vai su App → Esplora, trova HyperPay e clicca su Installa.
- 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.
- Nella scheda Impostazioni, scegli Modalità Sandbox con le credenziali di test o Modalità Live con quelle live.
- Consigliato: clicca su Copia URL del webhook, aggiungilo nella dashboard di HyperPay e incolla la sua chiave di decrittazione in Secret del webhook.
- Vai su Impostazioni negozio → Metodi di pagamento e attiva HyperPay. Facoltativo: imposta uno Sconto per ordini prepagati.
- 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?
- Come collego Geidea al mio negozio?