Apple Pay pour PrestaShop Checkout – PrestaShop

Apple Pay est un moyen de paiement mobile développé par Apple. Son intégration à PrestaShop Checkout permet à vos clients de payer via ce service.

⚠️ Apple Pay est disponible pour les versions 1.7 et 8 de PrestaShop.

Comment configurer Apple Pay pour PrestaShop Checkout

Avant toute chose, assurez-vous que vous utilisez la dernière version de PrestaShop Checkout. Pour cela rendez-vous sur votre back-office dans le menu gestionnaire de modules.

Voici maintenant les étapes de configuration :

1. Cliquez sur "Configurer" le module. Puis rendez-vous sur l’onglet Paramètres de paiement. Localisez la section Activer les moyens de paiement et cliquez sur le bouton Modifier.

2. Vous y trouverez l’option Apple Pay, activez-la si ce n’est pas déjà fait, et cliquez sur "Configurer".

3. Cliquez sur « Enregistrer votre domaine ».

4. PrestaShop Checkout examinera si le fichier de vérification de domaine est disponible sur votre serveur pour utiliser Apple Pay. Pour le dépannage si le fichier de domaine n’est pas disponible, consultez la section Dépannage ci-dessous.

5. Ensuite, enregistrez votre domaine Apple Pay sur votre compte PayPal.

6. Une fois la vérification réussie, vous verrez un message de confirmation sur votre interface PrestaShop Checkout.

Après l’enregistrement réussi de votre domaine, Apple Pay fonctionnera pleinement sur votre boutique PrestaShop.

Remarque : si l’enregistrement automatique échoue, vous pouvez essayer d’enregistrer manuellement votre domaine au sein de PayPal. Contactez le support PrestaShop Paypal si vous rencontrez des difficultés. (Production ou Sandbox).

Dépannage du domaine lorsque le fichier d’enregistrement n’est pas disponible

Le module utilise le moduleRoutes pour exposer automatiquement le fichier de vérification du domaine grâce à une route dynamique.

Ventilation des problèmes

1. Point dans le chemin d’accès de l’URL :

Par défaut, Nginx et certaines configurations de serveur peuvent bloquer les URL contenant un point dans les routes dynamiques. Il s’agit d’une fonctionnalité de sécurité courante pour empêcher l’accès à des fichiers involontaires.
Le système de routage de PrestaShop peut ne pas gérer correctement ces URL si la plateforme n’est pas installée dans le répertoire racine.

2. Installation sans racine :

Si PrestaShop est installé dans un sous-répertoire (par exemple, https://example.com/shop/), le moduleRoutes peut ne pas mapper correctement le chemin/.well-known/.

3. Comportement spécifique au serveur :

Apache gère souvent ces routes via des règles .htaccess, mais Nginx nécessite des configurations explicites pour permettre l’accès à .well-known.

Options possibles :

1. Placement des fichiers statiques

Si possible, contournez le routage dynamique en plaçant le fichier apple-developer-merchantid-domain-association de manière statique dans le répertoire .well-known de la racine de votre domaine :

Étapes :

Créez le répertoire .well-known à la racine de votre serveur.
Placez-y le fichier apple-developer-merchantid-domain-association.
Configurez votre serveur pour qu’il serve le répertoire « .well-known » si nécessaire.

Avantages : évite complètement les problèmes de routage.

Inconvénients : nécessite un placement manuel des fichiers.

2. Configuration Nginx sur mesure

Pour les serveurs Nginx, autorisez explicitement l’accès aux URL .well-known :

Ajoutez le bloc suivant à votre configuration Nginx :

location /.well-known/ {
allow all;
root /path/to/prestashop/root;
}

Avantages : permet une gestion dynamique et prend en charge le système de routage de PrestaShop.

Inconvénients : nécessite un accès au niveau du serveur pour modifier les configurations.

Téléchargez et hébergez le fichier d’association du domaine sandbox

Questions fréquentes

J'ai fait des tests de paiement et ils ne sont pas pris en compte, que faire ?

Attention lors des tests de paiement en production.

Les paiements Apple Pay sont traités comme des paiements par carte, ils sont soumis au système de détection de fraude, basé sur de l’IA et qui analyse le comportement de l’utilisateur et les données de la transaction pour calculer un score de risque.

Les paiements avec de faible montant et des données produits de test sont classés comme suspect et peuvent déclencher un blocage des transactions. La numéro de carte peut se retrouver sur liste noire pendant quelques heures.

Pour les tests de paiement, il est préférable d’utiliser le mode sandbox ou de réaliser une transaction authentique avec un vrai produit dans le panier. A noter que si des tentatives de paiement ont été faites, il vaut mieux changer de carte au cas où le système aurait déjà enregistré cette carte comme potentiellement frauduleuse (seulement pour quelques heures).