# Nexi XPay pour HBook

<a id="1-activez-nexi-xpay-comme-passerelle-de-paiement"></a>

## 1\. Activez Nexi XPay comme passerelle de paiement.

- Une fois que vous avez activé le plugin Nexi XPay pour HBook, vous devez **valider la licence** dans **HBook > Licence**.  
![image-20251011-193700.png](./attachments/image-20251011-193700.png)
- Définir Nexi XPay comme passerelle de paiement active dans **HBook > Paiement >Activer les passerelles de paiement**

<a id="2-dans-hbook-ajoutez-les-identifiants-nexi-xpay"></a>

## 2\. Dans HBook, ajoutez les identifiants Nexi XPay.

Entrez vos informations Nexi XPay dans **HBook > Paiement > Paramètres Nexi XPay**.

![image-20251011-193911.png](./attachments/image-20251011-193911.png)

<a id="où-puis-je-trouver-la-clé-api-pour-lenvironnement-live"></a>

### Où puis-je trouver la clé API pour l'environnement Live ?

Pour le **Environnement de test,** Le compte test Nexi XPay est utilisé par défaut. Vous n'avez pas besoin de spécifier de clé API.

Pour le **Environnement de vie**, cette clé est générée dans le back-office XPay.

Pour générer les nouvelles informations d'identification pour l'environnement de production, procédez comme suit :

1. Connectez-vous à [Back-office Web XPay](https://xpaydashboard.nexigroup.com/login).
2. Dans le **Admin** section, cliquez sur **Clé API**.
3. Cliquez sur **Ajouter une nouvelle clé API**.
4. Une fois le terminal sélectionné, cliquez sur **Ajouter** pour générer la clé API de production.

<a id="modes-de-paiement-nexi-xpay"></a>

### Modes de paiement Nexi XPay

Vous activerez les modes de paiement que vous souhaitez autoriser directement dans **Tableau de bord Nexi XPay**Certaines méthodes de paiement ne sont disponibles que dans certains pays. [Liste des modes de paiement Nexi XPay](https://developer.nexigroup.com/xpayglobal/en-EU/docs/payment-methods/).

<a id="où-puis-je-trouver-des-cartes-de-test"></a>

## Où puis-je trouver des cartes de test ?

Vous trouverez des informations sur les tests de paiement dans la documentation Nexi XPay : [Environnement de test](https://developer.nexigroup.com/xpayglobal/en-EU/docs/test-environment/)

> [!INFO]
> Il n'est pas possible d'effectuer des tests dans un environnement local. Même l'environnement « Test » pour Nexi Xpay for HBook doit être réalisé sur un site de préproduction en ligne. Cela est dû aux exigences de Nexi concernant les paramètres qui ne peuvent pas être utilisés avec une URL locale.

<a id="comment-personnaliser-la-page-de-paiement-nexi-xpay"></a>

## Comment personnaliser la page de paiement Nexi XPay ?

Depuis le portail Back Office, vous pouvez personnaliser la page de paiement en insérant le logo de votre boutique.

<a id="ip-à-ajouter-à-la-liste-blanche-pour-recevoir-les-notifications-webhook"></a>

## IP à ajouter à la liste blanche pour recevoir les notifications webhook

Nexi XPay envoie une notification utilisée par HBook pour récupérer le statut du paiement. Vous devrez peut-être vérifier auprès de votre hébergeur que les domaines et adresses IP suivants sont autorisés.

**Domaine**:

- [*stg-ta.nexigroup.com*](http://stg-ta.nexigroup.com)
- [*xpay.nexigroup.com*](http://xpay.nexigroup.com)

**Adresses IP**:

- 185.198.117.13
- 185.198.117.14
- 185.198.118.13
- 185.198.118.14