Synchronisation de l’état · Monobank
Monobank — le paiement est inscrit sur l’ordre par lui-même
BêtaBeta: disponible pour se connecter aujourd’hui; les capacités du canal sont encore en cours de perfectionnement.
L’acheteur paie une facture, le CRM reçoit une confirmation signée à partir de Monobank, met le paiement sur la commande et informe immédiatement votre équipe. Pas de réconciliation des déclarations à la main.
Webhook log
webhook received · order #SHOP-10245
x-sign
OK
synced automatically
Status → Confirmed
Comment ça marche
Webhook signé
Monobank envoie l’état de la facture avec un en-tête x-sign. Le CRM lit l’organisme de demande brute et vérifie la signature ECDSA contre la clé publique de votre marchand — sinon il n’accepte rien.
Paiement sur commande
Un relevé de paiement est créé avec le montant, la monnaie, la méthode et le statut, liés à la commande par la référence de facture.
État de la commande
L’ordre passe à « Confirmé » s’il est toujours « En attente » et les paiements couvrent le total de la commande.
Votre équipe est informée
Un paiement réussi produit une notification de cloche et pousse le propriétaire et les gestionnaires — exactement un, même si la banque l’a retransmise.
Journal des paiements
Chaque paiement de chaque fournisseur dans une liste avec recherche, filtres et link state. Vous pouvez voir ce qui a été payé, même si aucune commande n’existe encore.
Le paiement partiel est visible
La facture indique un état dérivé — impayé, partiel ou payé — basé sur les paiements réels dans la monnaie de la commande.
Lorsque la responsabilité prend fin
- Le CRM accepte
- signated facture status webhooks; Monobank n’envoie pas l’état expiré par webhook, donc qui a créé la facture suit que
- Les registres CRM
- id de facture, statut, le montant réel et la monnaie; la référence de facture → l’identifiant externe de la commande
- Le CRM peut changer
- "Pending" → "Confirmé", et seulement pour un paiement réussi qui couvre la commande dans la bonne devise
- Le CRM crée
- une facture lorsqu’un gestionnaire appuie sur le lien de paiement d’une commande ou d’une facture — Monobank héberge la page de paiement, et le lien reste payable pour une journée
- Le CRM ne le fait jamais
- annuler les factures, les remboursements, les paiements fractionnés, le chargement d’une carte ou le stockage des données de la carte
- Monnaies
- Hryvnia, plus dollar et euro — la monnaie provient du code numérique ISO-4217 dans le hook, et les montants sont convertis à partir d’unités mineures
Un paiement qui n’a pas trouvé de commande n’est pas perdu
- Si la référence de la facture ne correspond pas à une commande, le paiement est toujours stocké — dans Commerce → Paiements, marqués comme non liés.
- Un gestionnaire l’ouvre et le lie à une commande existante ou en crée une nouvelle, avec l’acheteur et le montant déjà connu.
- L’itinéraire inverse fonctionne aussi depuis l’ordre : choisissez un paiement non lié existant dans la liste.
- Un paiement peut être enregistré à la main — pour des espèces ou un virement bancaire qui n’a jamais été effectué en acquérant du tout.
- Un webhook retransmis ne crée pas de duplicata : l’enregistrement est idémpotent sur l’id de la facture.
La vérification de compte est un diagnostic, pas une barrière
Le callback fonctionne au moment où le jeton marchand est sauvegardé : un événement correctement signé de Monobank s’authentifie, si exigeant "passer un test d’abord" serait un obstacle artificiel entre vous et un paiement réel. Si vous le voulez, le test de connexion effectue une lecture sûre et montre à quel compte le jeton appartient, ne changeant rien dans le CRM.
Configuration
- 01
Ajouter l’adaptateur Monobank
Collez le jeton marchand de votre espace client d’achat de Monobank. L’adresse webhook apparaît sur la page de l’adaptateur créé. Le jeton est stocké crypté.
- 02
Passez l’adresse dans webHookUrl
Votre magasin ajoute cette adresse au champ webHookUrl de chaque demande de création de facture — le API officiel ne décrit aucun webhook marchand mondial. Mettez l’identifiant externe de la commande CRM dans marchandPaymInfo.référence: c’est ainsi que le paiement trouve sa commande.
- 03
Vérifier avec un paiement réel
Faites un paiement authentique. Il devrait apparaître dans le journal et sur la commande, et votre équipe devrait obtenir la notification.
Foire aux questions
- Comment puis-je connecter Monobank au CRM?
- Ajoutez l’adaptateur Monobank sous Paramètres → Intégrations, collez le jeton marchand de votre espace client d’acquisition et copiez l’adresse webhook. Votre magasin passe ensuite cette adresse dans le champ webHookUrl lors de la création d’une facture — et les paiements commencent à apparaître dans le CRM.
- Ai-je besoin d’un test séparé avant d’accepter les paiements réels?
- C’est pas vrai. Un événement signé à partir de Monobank s’authentifie, de sorte que les webhooks sont acceptés dès que le jeton est enregistré. Le test de connexion est disponible en tant que diagnostic, mais n’est pas une condition préalable.
- Est-ce que les données de la carte CRM stockent?
- C’est pas vrai. Le numéro de carte et CVV n’atteignent jamais le CRM et ne sont jamais stockés. Seul le montant, la monnaie, le statut et l’identité de la facture sont conservés — suffisamment pour rapprocher le paiement de la commande.
- Comment le CRM trouve-t-il le bon ordre?
- Par le champ de référence de la facture : votre magasin met l’identificateur externe de la commande là, et le CRM recherche une commande avec exactement cet identifiant dans votre espace de travail. Un webhook ne peut pas atteindre les ordres d’un autre espace de travail.
- Et si la référence ne correspond pas ?
- Le paiement n’est pas annulé. Il est stocké dans le journal des paiements comme non lié, et un gestionnaire le lie à un ordre existant ou en crée un nouveau.
- Le CRM crée-t-il des factures ou émet-il des remboursements?
- Une facture, oui — lorsque vous en demandez une: le bouton "Lien de paiement" sur une commande ou une facture soulève une facture de Monobank et renvoie un lien pour que le gestionnaire envoie l’acheteur. Remboursements, annulation de facture et tous les frais restent avec Monobank et votre magasin; le CRM ne fait aucun d’eux.
- D’autres fournisseurs peuvent-ils être acceptés de la même manière?
- Oui. LiqPay, WayForPay et Hutko se connectent de la même manière et écrivent dans le même journal de paiement — chacun avec son propre système de signature, exactement comme l’exige la documentation officielle de ce fournisseur.
En savoir plus
Communément reliés entre eux
LiqPay
BêtaUn paiement confirmé sur le côté de LiqPay soulève une alerte d’équipe et met à jour une commande correspondante dans le CRM.
En savoir plusWayForPay
DisponibleLe CRM vérifie chaque résultat de paiement, alerte votre équipe et lie le paiement à une commande existante. Sans match, il reste dans une file d’attente de réconciliation claire.
En savoir plusHutko
DisponibleAprès chaque paiement, le CRM enregistre le résultat, alerte votre équipe et fixe le paiement à une commande existante ou le maintient dans une file d’attente de rapprochement claire.
En savoir plusRozetka
BêtaLe plus grand marché de l’Ukraine: les commandes arrivent dans le CRM de leur propre, les statuts et les stocks retournent au cabinet du vendeur, et les questions de l’acheteur deviennent des pistes avec un propriétaire et une étape suivante.
En savoir plusProm.ua
DisponibleLes commandes, les paiements et la livraison arrivent seuls. Les questions d’acheteur deviennent des pistes vous répondez directement du CRM, sans ouvrir l’espace client Prom.
En savoir plus
Bêta: Beta: disponible pour se connecter aujourd’hui; les capacités du canal sont encore en cours de perfectionnement.
Connecter Monobank
L’acquisition de paiements est effectuée par eux - mêmes, et ceux qui ne trouvent pas d’ordre attendent dans le journal au lieu de disparaître.