# Connecter votre compte Xendit

> Encaissez par carte, QRIS, portefeuille électronique et virement bancaire en Asie du Sud-Est avec votre propre compte Xendit. Dans Paramètres > Paiements, cliquez sur Configurer Xendit, collez votre clé API secrète et votre jeton de vérification du webhook, choisissez votre pays, ajoutez notre URL de webhook dans Xendit, activez-le et cliquez sur Enregistrer les paramètres.

Centre d’aide / Paiements - Mis à jour le 19 novembre 2026

Xendit est un prestataire de paiement pour les entreprises d'Indonésie, des Philippines, du Vietnam, de Thaïlande, de Singapour et de Malaisie. Quand vous connectez votre compte Xendit, vos clients peuvent payer par carte, en scannant un code QRIS, avec des portefeuilles électroniques comme OVO, DANA, GoPay, ShopeePay, GCash et Maya, par virement bancaire sur un compte virtuel, ou dans un point de vente, selon les moyens de paiement que vous avez activés dans Xendit. Les paiements arrivent directement sur votre compte Xendit, et Shoprocket prend 0 %.

Quand un client clique sur **Payer maintenant**, il est redirigé vers la page de paiement sécurisée de Xendit pour choisir comment payer, puis revient dans votre boutique. Les informations de carte vont directement à Xendit et ne passent jamais par Shoprocket.

## Avant de commencer

Il vous faut un compte Xendit et trois éléments de votre tableau de bord Xendit :

1. Votre **clé API secrète**, dans **Settings > API keys**. Quand vous créez la clé, donnez-lui l'accès en écriture à **Money-in**, pour qu'elle puisse encaisser les paiements et effectuer les remboursements.
2. Votre **jeton de vérification du webhook**, dans **Settings > Webhooks**.
3. Le pays dans lequel votre compte Xendit est enregistré.

## Connecter Xendit

1. Dans votre tableau de bord, allez dans **Paramètres > Paiements**.
2. Sur la carte Xendit dans **Passerelles de paiement**, cliquez sur **Configurer Xendit**.
3. Collez votre **Secret API key** et votre **Webhook verification token** dans les champs du même nom.
4. Sous **Country**, choisissez le pays dans lequel votre compte Xendit est enregistré.
5. Copiez l'**URL du webhook** affichée sous les champs.
6. Dans votre tableau de bord Xendit, allez dans **Settings > Webhooks**. Collez l'URL dans les champs de webhook pour **Payment Session**, **Payments** et **Refunds**, et enregistrez-les.
7. De retour dans Shoprocket, mettez l'interrupteur de Xendit sur **Activé** et cliquez sur **Enregistrer les paramètres**.

![La carte Xendit dans Paramètres > Paiements : les champs de clé secrète, de jeton de webhook et de pays, avec l'URL du webhook à copier en dessous](https://shoprocket.io/img/help/connect-xendit/xendit-setup.webp)

À l'enregistrement, Shoprocket vérifie votre clé secrète auprès de Xendit. Si Xendit la refuse, rien n'est enregistré et un message en haut de l'écran en donne la raison. L'erreur la plus courante est de coller la clé publique, qui commence par `xnd_public_`. La clé secrète commence par `xnd_development_` ou `xnd_production_`.

La carte indique alors **Connecté**, et Xendit apparaît dans votre paiement.

## Pourquoi l'URL du webhook est importante

Beaucoup de clients en Asie du Sud-Est terminent leur paiement en dehors de votre boutique. Un client peut scanner un code QRIS avec son application bancaire, approuver un paiement par portefeuille électronique sur son téléphone, ou régler un compte virtuel plusieurs heures plus tard. Xendit informe Shoprocket de chaque paiement via l'URL du webhook. Shoprocket vérifie ensuite le paiement auprès de Xendit avant de marquer la commande comme payée.

Sans le webhook, une commande payée de cette façon peut rester **En cours de traitement** jusqu'à ce que le client revienne dans votre boutique. Ajoutez l'URL dans Xendit avant de commencer à vendre.

## La devise acceptée par votre compte

Chaque compte Xendit accepte les paiements dans la devise de son pays : roupie indonésienne, peso philippin, dong vietnamien, baht thaïlandais, dollar de Singapour ou ringgit malaisien. Le pays que vous choisissez détermine la devise, et la carte l'affiche une fois que vous avez enregistré.

Si votre boutique est tarifée dans une autre devise, la carte vous avertit. Xendit ne peut alors pas être votre passerelle de carte principale, mais vous pouvez quand même le proposer aux clients qui paient dans sa devise. Pour cela, ajoutez cette devise sous **Passerelle de carte par devise**, comme l'explique [Choisir une passerelle de paiement](https://shoprocket.io/fr/aide/choisir-une-passerelle-de-paiement.md).

Xendit accepte la roupie en montants entiers. Si un prix comporte des centimes, il est arrondi à la roupie la plus proche au moment du paiement.

## L'essayer en mode test

Xendit donne à chaque compte un mode test avec sa propre clé secrète, qui commence par `xnd_development_`. Collez la clé de test pour essayer votre paiement sans déplacer d'argent réel. La carte affiche alors **Identifiants de test : aucun argent réel n'est déplacé**. Sur la page de paiement de test de Xendit, vous pouvez simuler un paiement réussi pour chaque moyen de paiement.

Quand vous êtes prêt à vendre, cliquez sur **Modifier les identifiants Xendit**, collez votre clé secrète live (elle commence par `xnd_production_`), choisissez à nouveau votre pays et cliquez sur **Enregistrer les paramètres**. Le jeton de vérification du webhook et les URL de webhook se règlent séparément pour le mode test et le mode live dans Xendit, ajoutez donc aussi l'URL en mode live.

## Comment vos clients paient

- **Par carte** : le client saisit sa carte sur la page de Xendit. Si sa banque doit vérifier le paiement, la vérification s'ouvre là aussi.
- **Avec QRIS ou un portefeuille électronique** : le client scanne le code ou approuve le paiement dans son application de portefeuille. La commande est confirmée dès que Xendit nous indique que le paiement est passé.
- **Par compte virtuel ou dans un point de vente** : le client reçoit un numéro sur lequel payer. La commande reste **En cours de traitement** jusqu'à ce qu'il paie, et les articles restent réservés tant que la page de paiement de Xendit est ouverte.

Si un client quitte la page de Xendit sans payer, il peut cliquer à nouveau sur **Payer maintenant** depuis son panier pour revenir à la même page. Une fois la page expirée, une nouvelle s'ouvre.

## Remboursements

Quand vous remboursez une commande payée avec Xendit, l'argent retourne automatiquement au client, en totalité ou en partie. Voir [Rembourser une commande](https://shoprocket.io/fr/aide/rembourser-une-commande.md). Certains portefeuilles électroniques et moyens de paiement par virement bancaire ne peuvent pas être remboursés en partie, ou pas du tout, via Xendit. Dans ce cas, le remboursement apparaît comme échoué avec la raison. Vous pouvez alors rembourser le montant total ou rembourser vous-même le client. Un remboursement effectué dans votre tableau de bord Xendit apparaît aussi sur la commande dans Shoprocket.

Les remboursements sont prélevés sur votre solde Xendit, veillez donc à ce qu'il soit suffisant pour les couvrir.

## Abonnements

Xendit ne peut pas encore renouveler les abonnements sur Shoprocket. Si vous vendez des abonnements, gardez une autre passerelle de carte qui les renouvelle, comme Stripe, pour ces produits.

## Modifier vos identifiants ou le désactiver

Une fois Xendit connecté, son bouton indique **Modifier les identifiants Xendit**. Vos identifiants enregistrés sont stockés chiffrés et ne sont plus jamais affichés. Pour les conserver, laissez les champs vides. Pour les remplacer, remplissez les trois champs et cliquez sur **Enregistrer les paramètres**.

Pour ne plus proposer Xendit, mettez son interrupteur sur **Désactivé** et cliquez sur **Enregistrer les paramètres**. Vos identifiants restent enregistrés, vous pouvez donc le réactiver à tout moment. Les paiements que des clients avaient déjà commencés aboutissent quand même.

## Articles liés

- [Choisir une passerelle de paiement](https://shoprocket.io/fr/aide/choisir-une-passerelle-de-paiement.md)
- [Rembourser une commande](https://shoprocket.io/fr/aide/rembourser-une-commande.md)
- [Passer une commande de test](https://shoprocket.io/fr/aide/passer-une-commande-de-test.md)

[Ouvrir Paiements dans votre tableau de bord](https://app.shoprocket.io/go/settings/payments)

---

- HTML version: https://shoprocket.io/fr/aide/connecter-xendit
- Language: Français (fr)
- Also in: [العربية](https://shoprocket.io/ar/help/connect-xendit.md), [Deutsch](https://shoprocket.io/de/hilfe/xendit-konto-verbinden.md), [Ελληνικά](https://shoprocket.io/el/help/connect-xendit.md), [English](https://shoprocket.io/help/connect-xendit.md), [Español](https://shoprocket.io/es/ayuda/conectar-xendit.md), [עברית](https://shoprocket.io/he/help/connect-xendit.md), [हिन्दी](https://shoprocket.io/hi/help/connect-xendit.md), [Bahasa Indonesia](https://shoprocket.io/id/bantuan/hubungkan-akun-xendit.md), [Italiano](https://shoprocket.io/it/aiuto/collega-xendit.md), [日本語](https://shoprocket.io/ja/help/connect-xendit.md), [Lietuvių](https://shoprocket.io/lt/pagalba/prijunkite-xendit-paskyra.md), [Norsk](https://shoprocket.io/nb/hjelp/koble-til-xendit-kontoen-din.md), [Nederlands](https://shoprocket.io/nl/hulp/xendit-account-koppelen.md), [Polski](https://shoprocket.io/pl/pomoc/polacz-konto-xendit.md), [Português](https://shoprocket.io/pt/ajuda/conectar-xendit.md), [Română](https://shoprocket.io/ro/ajutor/conecteaza-contul-xendit.md), [Русский](https://shoprocket.io/ru/help/connect-xendit.md), [ไทย](https://shoprocket.io/th/help/connect-xendit.md), [Türkçe](https://shoprocket.io/tr/yardim/xendit-hesabi-baglama.md), [中文](https://shoprocket.io/zh/help/connect-xendit.md)
