# Bagaimana cara menghubungkan HyperPay ke toko saya?

HyperPay memungkinkan pelanggan di Arab Saudi membayar secara online dengan mada, Visa, Mastercard, Apple Pay, dan STC Pay di halaman pembayaran yang aman. Setiap akun HyperPay bekerja dalam satu mata uang (SAR, AED, QAR, EGP, atau USD) dan hanya muncul saat checkout jika harga Anda dalam mata uang tersebut.

## Langkah-langkah

1. Dapatkan kredensial Anda dari HyperPay: sebuah **access token** dan satu **entity ID** per kelompok pembayaran (Visa / Mastercard, mada, dan, jika diaktifkan, Apple Pay dan STC Pay).
2. Di Dropify, buka **Aplikasi → Jelajahi**, cari **HyperPay** lalu klik **Instal**.
3. Di halaman aplikasi, klik **Hubungkan HyperPay** (atau **Tambah akun**), masukkan **Nama akun**, tempel **Access token** dan **Entity ID (Visa / Mastercard)**, tambahkan entity ID opsional untuk mada, Apple Pay, dan STC Pay, pilih **Mata uang akun** (SAR untuk akun Saudi) lalu simpan. Dropify memeriksa setiap entity ke HyperPay.
4. Di kartu **Pengaturan**, pilih **Mode Sandbox** dengan kredensial uji atau **Mode Live** dengan kredensial live.
5. Direkomendasikan: klik **Salin URL webhook**, tambahkan di dasbor HyperPay, lalu tempel kunci dekripsinya ke **Webhook secret**.
6. Buka **Pengaturan toko → Metode pembayaran** lalu aktifkan **HyperPay**. Opsional: atur **Diskon untuk pesanan pra-bayar**.
7. Buat pesanan uji coba: pelanggan memilih mada, kartu, Apple Pay, atau STC Pay, lalu membayar.

Hanya metode yang entity ID-nya Anda isi yang ditawarkan kepada pelanggan.

## Masalah umum

- "HyperPay menolak kunci ini dalam mode uji" → token atau salah satu entity ID milik lingkungan yang lain. Gunakan kredensial uji dalam Mode Sandbox.
- mada tidak ada di halaman pembayaran → tambahkan **Entity ID (mada, opsional)**; mada selalu memiliki entity sendiri.
- HyperPay tidak muncul saat checkout → mata uang toko Anda berbeda dari **Mata uang akun**, akun berstatus Tidak aktif, atau HyperPay nonaktif di Metode pembayaran.
- Pesanan tetap berstatus belum dibayar saat pelanggan menutup halaman → tambahkan webhook (langkah 5).

## Terkait

- available payment gateways by country
- [Bagaimana cara menghubungkan Moyasar ke toko saya?](https://help.dropify.shop/id/payments_gateways/moyasar/)
- [Bagaimana cara menghubungkan Geidea ke toko saya?](https://help.dropify.shop/id/payments_gateways/geidea/)
