Les passerelles de paiement sont des documents permettant de créer un lien entre les documents de facturation et de paiement de dokos et des intermédiaires de paiement comme Stripe, Braintree, GoCardless, Paypal, etc...
Les passerelles de paiement sont des documents permettant de créer un lien entre les documents de facturation et de paiement de Dokos avec des intermédiaires de paiement comme Stripe, Braintree, GoCardless, Paypal, etc.
### 1. Comment sont structurés les passerelles de paiement
### 1. Structures des passerelles de paiement
Une nouvelle passerelle de paiement est automatiquement créée lorsque vous configurez une nouvelle intégration avec un intermédiaire de paiement dans dokos.
Une nouvelle passerelle de paiement est automatiquement créée lorsque vous configurez une nouvelle intégration avec un intermédiaire de paiement dans Dokos.
Exampe: Lorsque vous ajoutez un nouveau compte Stripe appelé `ABC`, une passerelle de paiement appelée `Stripe-ABC` est automatiquement créée dans dokos.
Exemple: lorsque vous ajoutez un nouveau compte Stripe appelé `ABC`, une passerelle de paiement appelée `Stripe-ABC` est automatiquement créée dans Dokos.
Une passerelle de paiement est ensuite liée à un ou plusieurs comptes comptable, un compte pour chaque devise utilisée pour payer.
Une passerelle de paiement est ensuite liée à un ou plusieurs comptes comptables, un compte pour chaque devise utilisée pour payer.
Exemple: Si vous souhaitez traiter des paiements en EUR ou USD, vous devez créer deux comptes de passerelle de paiement liés à votre passerelle de paiement:
Exemple : si vous souhaitez traiter des paiements en EUR ou USD, vous devez créer deux comptes de passerelle de paiement liés à votre passerelle de paiement :
- Un compte de passerelle de paiement avec la devise EUR, lié à un compte comptable en EUR
- Un compte de passerelle de paiement avec la devise EUR, lié à un compte comptable en EUR
- Un compte de passerelle de paiement avec la devis USD, lié à un compte comptable en USD
- Un compte de passerelle de paiement avec la devise USD, lié à un compte comptable en USD
Chaque fois qu'un paiement est effectué via cette passerelle de paiement, le système comptabilise l'écriture de paiement sur le bon compte de passerelle de paiement.
Chaque fois qu'un paiement est effectué via cette passerelle de paiement, le système comptabilise l'écriture de paiement sur le bon compte de passerelle de paiement.
...
@@ -22,28 +22,28 @@ Il est possible de définir les éléments suivants pour chaque passerelle de pa
...
@@ -22,28 +22,28 @@ Il est possible de définir les éléments suivants pour chaque passerelle de pa
- Pour la génération automatique des écritures de paiement:
- Pour la génération automatique des écritures de paiement:
- Un mode de paiement
- Un mode de paiement
- Un compte de frais: Utilisé pour comptabiliser les frais prélevés par l'intermédiaire de paiement
- Un compte de frais : utilisé pour comptabiliser les frais prélevés par l'intermédiaire de paiement
Afin de configurer une intégration avec Stripe, vous devez ajouter les éléments suivants:
Afin de configurer une intégration avec Stripe, vous devez ajouter les éléments suivants:
- Créez un nouveau document `Paramètres Stripe` pour chacune de vos sociétés
- Créez un nouveau document `Paramètres Stripe` pour chacune de vos sociétés
> Allez dans `Intégrations > Paramètres Stripe`
> Allez dans `Intégrations > Paramètres Stripe`
- Ajoutez la clé publiable
- Ajoutez la clé publiable
- Ajoutez la clé secrète
- Ajoutez la clé secrète
> Ces clés peuvent être trouvées dans la section `Développeur > Clés API` du tableau de bord Stripe.
> Ces clés peuvent être trouvées dans la section `Développeur > Clés API` du tableau de bord Stripe.
- Ajoutez une image d'en-tête: elle sera affichée au dessus du formulaire de paiement sur votre portail, mais ça n'est pas obligatoire
- Ajoutez une image d'en-tête : elle sera affichée au-dessus du formulaire de paiement sur votre portail, mais ce n'est pas obligatoire.
- Ajoutez une URL de redirection si différente de l'URL de redirection standard.
- Ajoutez une URL de redirection si différente de l'URL de redirection standard.
> Après un paiement réussi, l'utilisateur est redirigé vers une page de `Succès de paiement` (`/integrations/payment-success`) contenant un bouton `continuer`. Vous pouvez définir le lien de redirection de ce bouton dans ce champ.
> Après un paiement réussi, l'utilisateur est redirigé vers une page de `Succès de paiement` (`/integrations/payment-success`) contenant un bouton `continuer`. Vous pouvez définir le lien de redirection de ce bouton dans ce champ.
...
@@ -54,19 +54,19 @@ Afin d'activer les webhooks, allez dans votre tableau de bord Stripe, sélection
...
@@ -54,19 +54,19 @@ Afin d'activer les webhooks, allez dans votre tableau de bord Stripe, sélection
Remplacez {votre_site} et {nom_de_votre_compte_stripe} par l'URL de votre site (exemple: `myerp.dokos.io`) et le nom de votre compte Stripe dans dokos (exemple: `ABC`)
Remplacez {votre_site} et {nom_de_votre_compte_stripe} par l'URL de votre site (exemple : `myerp.dokos.io`) et le nom de votre compte Stripe dans Dokos (exemple : `ABC`).
Vous pouvez envoyez tous les événements liés au document:
Vous pouvez envoyer tous les événements liés au document :
- invoice
- invoice
Copiez ensuite la clé secrète et collez là dans votre compte Stripe sur dokos.
Copiez ensuite la clé secrète et collez la dans votre compte Stripe sur Dokos.
##### 3.1.3 Après la création
##### 3.1.3 Après la création
Une fois votre compte Stripe créé, allez dans les passerelles de paiement générées et complétez les informations présentées en section 2.
Une fois votre compte Stripe créé, allez dans les passerelles de paiement générées et complétez les informations présentées en section 2.
Si vous devez autoriser des paiements dans d'autres devises que la devise de votre société, ajoutez des comptes de passerelle de paiement additionnels.
Si vous devez autoriser des paiements dans d'autres devises que la devise de votre société, ajoutez des comptes de passerelle de paiement additionnels.
dokos est configuré pour accepter les devises suivantes dans Stripe:
Dokos est configuré pour accepter les devises suivantes dans Stripe :
Remplacez {votre_site} et {nom_de_votre_compte_stripe} par l'URL de votre site (exemple: `myerp.dokos.io`) et le nom de votre compte GoCardless dans dokos (exemple: `ABC`)
Remplacez {votre_site} et {nom_de_votre_compte_stripe} par l'URL de votre site (exemple : `myerp.dokos.io`) et le nom de votre compte GoCardless dans Dokos (exemple : `ABC`)
Vous pouvez laisser le champ `Secret` libre, car il sera automatiquement généré par GoCardless.
Vous pouvez laisser le champ `Secret` libre, car il sera automatiquement généré par GoCardless.
Enregistrez, puis copiez-collez le `Secret` généré dans vos paramètres GoCardless dans dokos.
Enregistrez, puis copiez-collez le `Secret` généré dans vos paramètres GoCardless dans Dokos.
##### 3.1.3 Vérifier les mises à jour
##### 3.1.3 Vérifier les mises à jour
En cochant `Vérifier les mises à jour`, vous autoriser une vérification quotidienne des éléments suivants:
En cochant `Vérifier les mises à jour`, vous autorisez une vérification quotidienne des éléments suivants:
- Le statut de chaque mandat est mis à jour si un changement est enregistré par GoCardless
- Le statut de chaque mandat est mis à jour si un changement est enregistré par GoCardless
- Le statut de chaque paiement est mis à jour si un changement est enregistré par GoCardless
- Le statut de chaque paiement est mis à jour si un changement est enregistré par GoCardless
Ces deux vérifications se font en plus des modifications effectuées par les webhooks reçus de GoCardless
Ces deux vérifications se font en plus des modifications effectuées par les webhooks reçus de GoCardless.