# ¿Cómo conecto HyperPay a mi tienda?

HyperPay permite a tus clientes en Arabia Saudí pagar en línea con mada, Visa, Mastercard, Apple Pay y STC Pay en una página de pago segura. Cada cuenta de HyperPay trabaja en una sola moneda (SAR, AED, QAR, EGP o USD) y solo aparece en el checkout si tus precios están en esa moneda.

## Pasos

1. Consigue tus credenciales de HyperPay: un **access token** y un **entity ID** por grupo de pago (Visa / Mastercard, mada y, si están activos, Apple Pay y STC Pay).
2. En Dropify, ve a **Aplicaciones → Descubrir**, busca **HyperPay** y haz clic en **Instalar**.
3. En la página de la app, haz clic en **Conectar HyperPay** (o **Agregar cuenta**), escribe un **Nombre de la cuenta**, pega el **Access token** y el **Entity ID (Visa / Mastercard)**, añade los entity IDs opcionales de mada, Apple Pay y STC Pay, elige la **Moneda de la cuenta** (SAR para cuentas saudíes) y guarda. Dropify comprueba cada entidad con HyperPay.
4. En la tarjeta **Configuración**, elige **Modo de Prueba** con credenciales de prueba o **Modo en Vivo** con las reales.
5. Recomendado: haz clic en **Copiar URL del webhook**, añádela en el panel de HyperPay y pega su clave de descifrado en **Secreto del webhook**.
6. Ve a **Ajustes de la tienda → Métodos de pago** y activa **HyperPay**. Opcional: define un **Descuento para pedidos prepagados**.
7. Haz un pedido de prueba: el cliente elige mada, tarjeta, Apple Pay o STC Pay y paga.

Solo se ofrecen los métodos para los que ingresaste un entity ID.

## Problemas frecuentes

- "HyperPay rechazó estas claves en modo prueba" → el token o un entity ID es del otro entorno. Usa credenciales de prueba en Modo de Prueba.
- mada no aparece en la página de pago → añade el **Entity ID (mada, opcional)**; mada siempre tiene su propia entidad.
- HyperPay no aparece en el checkout → tu moneda es distinta de la **Moneda de la cuenta**, la cuenta está Inactiva o HyperPay no está activado en Métodos de pago.
- Los pedidos quedan sin pagar cuando el cliente cierra la página → agrega el webhook (paso 5).

## Relacionado

- available payment gateways by country
- [¿Cómo conecto Moyasar a mi tienda?](https://help.dropify.shop/es/payments_gateways/moyasar/)
- [¿Cómo conecto Geidea a mi tienda?](https://help.dropify.shop/es/payments_gateways/geidea/)
