> For the complete documentation index, see [llms.txt](https://docs.thewalletcrew.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.thewalletcrew.io/connectors/fr/e-commerce/prestashop.md).

# PrestaShop

Ajoutez des boutons « Add to Wallet » Apple Wallet et Google Wallet à une vitrine PrestaShop à l'aide d'un module, d'une signature HMAC côté serveur et du SDK The Wallet Crew.

Ce guide ajoute un bouton « Add to Wallet » à la **section Mon compte** zone de **PrestaShop**, pour une Carte de fidélité ou d’adhésion (ou une carte-cadeau Wallet), en utilisant un identifiant disponible dans la session client PrestaShop.

<figure><img src="https://3852727835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlP7d71aYydav6e0pRkxc%2Fuploads%2Fgit-blob-8a12b0912cdde47c7a440aa3bc4a9ba07550c508%2Fimage%20(1)%20(1)%20(1)%20(1)%20(1).png?alt=media" alt="PrestaShop My Account page showing an Add to Wallet button next to the loyalty information"><figcaption><p>Résultat cible : un bouton « Add to Wallet » rendu pour le client connecté dans Mon compte.</p></figcaption></figure>

La personnalisation de la boutique PrestaShop se fait généralement via **des modules** et **des surcharges de thème**. Ce guide se concentre sur une approche basée sur un module afin de conserver les secrets côté serveur et de maintenir l’intégration facilement lors des mises à jour du thème.

## Fonctionnement

Le SDK, la règle HMAC, la mise en cache et la CSP sont expliqués dans [Fonctionnement du bouton Ajouter à Wallet](https://docs.thewalletcrew.io/connectors/fr/e-commerce.md#how-the-add-to-wallet-button-works). Ce guide utilise l’identifiant client PrestaShop comme clé d’identifiant externe `prestashop.customerId`.

## Prérequis

* Un modèle de carte et une émission de carte déjà configurés dans The Wallet Crew.
* L'identifiant du tenant The Wallet Crew disponible (utilisé par l'URL du script du SDK).
* Un identifiant stable disponible sur les pages authentifiées.
* Un nom de clé d’identifiant externe convenu lors de l’onboarding.

L’identifiant stable est souvent l’identifiant client PrestaShop. Un projet peut aussi utiliser un identifiant CRM s’il est stocké sur l’entité client et reste stable dans le temps.

## Où le bouton apparaît

Les emplacements courants sont :

* Le **section Mon compte** le tableau de bord, à côté du numéro de fidélité ou d’adhésion.
* Une page dédiée **Wallet / Fidélité** dans la zone du compte.
* Une page de liste de cartes-cadeaux, avec un bouton par carte-cadeau.

La disponibilité des hooks dépend du thème et de la version de PrestaShop. De nombreux projets utilisent un hook de module pour le tableau de bord du compte. Certains projets utilisent une surcharge de thème pour placer le bouton dans une section spécifique.

## Étapes de configuration

{% stepper %}
{% step %}

#### Choisissez le contrat d’identifiant externe

Les clés d’identifiant doivent rester stables dans le temps (exemple : `prestashop.customerId`). Dans l’attribut, la clé est écrite `prestashop.customer_Id`: voir [Fonctionnement du bouton Ajouter à Wallet](https://docs.thewalletcrew.io/connectors/fr/e-commerce.md#how-the-add-to-wallet-button-works). Le préfixe `neostore` est l'ancien nom de la plateforme et est conservé dans les identifiants techniques.

{% hint style="info" %}
Si le tenant The Wallet Crew utilise déjà une clé avec casse mixte, la modifier peut affecter les installations existantes. Traitez cela comme un sujet de migration.
{% endhint %}
{% endstep %}

{% step %}

#### Stockez la configuration du tenant et le secret côté serveur

L’identifiant du tenant peut être utilisé côté client. Le secret HMAC doit rester côté serveur.

Les approches courantes dans les déploiements PrestaShop sont :

* Les variables d’environnement injectées par la plateforme d’hébergement.
* Un stockage de configuration côté serveur géré par le module, avec un contrôle d’accès strict dans le back-office PrestaShop.
  {% endstep %}

{% step %}

#### Créez un petit module qui affiche le bouton

Le module généralement :

* S’enregistre sur un hook lié au compte, ou fournit un petit contrôleur pour une page de compte dédiée.
* Lit l’identifiant client connecté depuis le contexte de session.
* Calcule le HMAC en utilisant le secret côté serveur.
* Affecte l’identifiant du tenant, le modèle de Carte, la valeur de l’identifiant et le HMAC aux variables du template.
  {% endstep %}
  {% endstepper %}

## Validez le résultat

Suivez les [étapes de validation](https://docs.thewalletcrew.io/connectors/fr/e-commerce.md#how-the-add-to-wallet-button-works) de la vue d'ensemble du commerce électronique.

## Dépannage

Voir les [vérifications de dépannage](https://docs.thewalletcrew.io/connectors/fr/e-commerce.md#troubleshooting) de la vue d'ensemble du commerce électronique.

## FAQ

<details>

<summary><strong>Cela nécessite-t-il un module PrestaShop personnalisé ?</strong></summary>

Une surcharge de thème peut suffire lorsque les valeurs côté serveur sont déjà disponibles dans le contexte du template. Un module dédié est généralement préférable. Il évite de faire le calcul du HMAC dans les templates du thème et centralise le chargement du secret.

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.thewalletcrew.io/connectors/fr/e-commerce/prestashop.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
