Comment intégrer Xendit à systeme.io
Dans cet article, vous allez apprendre à intégrer votre compte Xendit à votre compte systeme.io.
Ce dont vous aurez besoin :
- un compte systeme.io
- un compte Xendit
Configuration sur votre compte systeme.io :
Afin de connecter votre compte Xendit depuis votre compte systeme.io, cliquez sur votre photo de profil, ensuite cliquez sur "Paramètres" dans votre photo de profil (1), puis redirigez-vous vers "Passerelles de paiement" (2).
Une fois au niveau des passerelles de paiement, vous cliquez sur "Connecter" au niveau de Xendit (3).
Un popup apparaîtra dans lequel vous devez saisir le nom de l'organisation, la clé du webhook et les jetons d'accès secret et public.
Installation et configuration dans votre compte Xendit :
Remarque : L'interface de Xendit est disponible uniquement en anglais. Les captures d'écran ainsi que les noms des menus utilisés dans cet article sont en anglais.
- Clés API :
Pour obtenir les clés API nécessaires à votre intégration, veuillez suivre les étapes ci-dessous :
Dans la barre latérale de gauche, cliquez sur Settings (Paramètres) (1).
Dans la section Configuration et intégration, cliquez sur Developers (Développeurs) (2).
a. Clé API secrète :
Cliquez sur + Generate secret key (+ Générer une clé secrète) (3).
Dans la popup qui s'affiche, sélectionnez les options suivantes :
Cliquez sur Generate key (Générer une clé). Vous devrez peut-être saisir un code à 6 chiffres qui vous sera envoyé. Une fois cette étape terminée, votre clé sera générée.
Remarques :
- Votre clé API secrète commence par « xnd_production » pour la clé API secrète en production.
- La clé API secrète générée ne peut plus être consultée par la suite. Si vous avez oublié ou égaré votre clé API secrète, veuillez supprimer la clé API secrète générée et en générer une nouvelle.
b. Clé API publique :
Il suffit de cliquer sur Copy (Copier) (4) sur le bouton bleu situé sous Public Key (Clé publique).
Remarque : votre clé API publique commencera par « xnd_public ».
-
Webhooks
Dans le même menu « Développeurs » où vous avez trouvé les clés API, faites défiler vers le bas jusqu'à la section Webhooks.
Activez la réessai automatique en cas d'échec d'un webhook en cliquant sur Enable auto-retry for failed webhook (Activer le réessai automatique pour les webhooks ayant échoué). Cela garantit que les événements de webhook ayant échoué seront automatiquement réessayés.
Pour obtenir votre jeton de vérification du webhook, cliquez sur View Webhook Verification Token (Afficher le jeton de vérification du webhook) (5).
Saisissez le mot de passe de votre compte, puis cliquez sur Confirm (Confirmer) (6).
Copy (Copiez) (7) le jeton et collez-le dans les paramètres d'intégration de votre compte systeme.io.
-
Devises prises en charge et restrictions
Avant de recevoir des paiements, assurez-vous que vos tunnels de vente et vos produits sont configurés en utilisant l’une des devises prises en charge par cette passerelle de paiement.
Xendit prend en charge les paiements ponctuels et récurrents, mais les règles exactes dépendent du lieu d’enregistrement de votre compte marchand :
a. Xendit Indonésie
- Acheteurs pris en charge : Indonésie (ID)
- Paiements récurrents (abonnements) : Oui
- Devises prises en charge : IDR
- Restrictions pour les marchands : votre compte marchand Xendit doit être enregistré en Indonésie.
b. Xendit Philippines
- Acheteurs pris en charge : Philippines (PH)
- Paiements récurrents (abonnements) : Oui
- Devises prises en charge : PHP et USD
- Restrictions pour les marchands : votre compte marchand Xendit doit être enregistré aux Philippines.
Que se passe-t-il en cas d'échec d'un paiement via Xendit ?
Outre la tentative principale de prélèvement automatique, trois autres tentatives seront effectuées à intervalles de 7 jours. Le délai entre chaque tentative ne peut pas être modifié.