# Wie verbinde ich HyperPay mit meinem Shop?

Mit HyperPay können Kunden in Saudi-Arabien online mit mada, Visa, Mastercard, Apple Pay und STC Pay auf einer sicheren Zahlungsseite bezahlen. Jedes HyperPay-Konto arbeitet in einer Währung (SAR, AED, QAR, EGP oder USD) und erscheint im Checkout nur, wenn Ihre Preise in dieser Währung sind.

## Schritte

1. Holen Sie Ihre Zugangsdaten von HyperPay ein: ein **Access Token** und eine **Entity ID** pro Zahlungsgruppe (Visa / Mastercard, mada und, falls aktiviert, Apple Pay und STC Pay).
2. Gehen Sie in Dropify zu **Apps → Entdecken**, suchen Sie **HyperPay** und klicken Sie auf **Installieren**.
3. Klicken Sie auf der App-Seite auf **HyperPay verbinden** (oder auf **Konto hinzufügen**), geben Sie einen **Kontiname** ein, fügen Sie das **Access-Token** und die **Entity-ID (Visa / Mastercard)** ein, ergänzen Sie die optionalen Entity-IDs für mada, Apple Pay und STC Pay, wählen Sie die **Kontowährung** (SAR für saudische Konten) und speichern Sie. Dropify prüft jede Entity bei HyperPay.
4. Wählen Sie in der Karte **Einstellungen** den **Sandbox-Modus** mit Test-Zugangsdaten oder den **Live-Modus** mit Live-Zugangsdaten.
5. Empfohlen: Klicken Sie auf **Webhook-URL kopieren**, fügen Sie sie im Dashboard von HyperPay hinzu und fügen Sie deren Entschlüsselungsschlüssel in **Webhook-Secret** ein.
6. Gehen Sie zu **Shop-Einstellungen → Zahlungsmethoden** und schalten Sie **HyperPay** ein. Optional: Legen Sie einen **Rabatt für Vorauszahlungen** fest.
7. Geben Sie eine Testbestellung auf: Der Kunde wählt mada, Karte, Apple Pay oder STC Pay und bezahlt dann.

Kunden werden nur die Methoden angeboten, für die Sie eine Entity-ID eingegeben haben.

## Häufige Probleme

- „HyperPay hat diese Schlüssel im Testmodus abgelehnt“ → Das Token oder eine Entity-ID gehört zur anderen Umgebung. Verwenden Sie im Sandbox-Modus Test-Zugangsdaten.
- mada fehlt auf der Zahlungsseite → Fügen Sie die **Entity-ID (mada, optional)** hinzu; mada hat immer eine eigene Entity.
- HyperPay erscheint nicht im Checkout → Ihre Shop-Währung weicht von der **Kontowährung** ab, das Konto ist Inaktiv, oder HyperPay ist in den Zahlungsmethoden ausgeschaltet.
- Bestellungen bleiben unbezahlt, wenn der Kunde die Seite schließt → Fügen Sie den Webhook hinzu (Schritt 5).

## Verwandte Artikel

- available payment gateways by country
- [Wie verbinde ich Moyasar mit meinem Shop?](https://help.dropify.shop/de/payments_gateways/moyasar/)
- [Wie verbinde ich Geidea mit meinem Shop?](https://help.dropify.shop/de/payments_gateways/geidea/)
