Intégration disponible · Hutko
Suivi des paiements de Hutko sans saisie manuelle des données
Disponible
Aprè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.
Hutko événement
SHA1 vérifié · ordre apparié
- Commande
- SHOP-2048
- Montant
- 5 000.00 UAH
- Dossier de paiement
- payé
Le CRM enregistre le résultat signé de Hutko. Le traitement des paiements reste sur le côté Hutko.
Comment un paiement est enregistré
Callback signé
Hutko affiche le résultat de paiement à l’unique URL généré pour votre intégration.
Vérification des marchandises
Le callback marchand_id doit correspondre à la configuration du marchand Hutko.
Dossier de paiement
Le CRM stocke le montant réglé et la monnaie dans le journal de paiement et n’invente jamais une commande à partir du seul paiement.
Réconciliation
Une commande entièrement couverte existante peut passer à Confirmé; un paiement non assorti reste dans le journal.
Contrat technique
- Critère de la CRM
- POST /api/v1/adaptateurs/hutko/{configId}
- Pouvoirs
- {"merchantId":"1703986","password":"..."}
- Signature
- SHA1 sur les champs de rappel non vides triés avec mot de passe marchand
- Données stockées
- commande, statut de paiement, montant, monnaie, identifiants de fournisseur, e-mail/téléphone optionnel de l’acheteur
Modèle de sécurité
- Rejete les callbacks pour un autre marchand_id
- Rejets de charges utiles non signées ou mal signées
- Ne stocke pas les jetons PAN, CVV ou cartes brutes
- Redacte les métadonnées sensibles à Hutko avant d’enregistrer des diagnostics
- Un contrôle local optionnel valide les détails enregistrés et la signature sans créer de paiement
Le CRM enregistre le résultat; il ne contrôle pas le paiement
Le CRM reçoit créé, traitement, approuvé, décliné, expiré et inversé les statuts et enregistre le montant réglé et la monnaie. Si order_id correspond à un ordre existant, le paiement lui est attaché ; sans égal, il reste sous Commerce → Paiements pour rapprochement. L’intégration ne crée pas de commandes et ne facture ni ne rembourse jamais d’argent. Un lien de paiement de Hutko est relevé de la carte de commande avec le bouton -Payment link. Il ne stocke pas non plus les jetons PAN, CVV ou cartes.
Configuration
- 01
Créer l’adaptateur Hutko
Dans Paramètres → Intégrations → Les adaptateurs de plate-forme choisissent Hutko, entrez l’ID marchand et la clé de paiement dans des champs séparés, puis sélectionnez Créer.
- 02
Coller les URL dans le portail Hutko
Pour tous les paiements marchands: Paramètres marchands → Paramètres de paiement → Callback du serveur URL. Pour un lien : Solutions de paiement → Liens de paiement → Fonctionnalités avancées → Callback du serveur URL. La valeur du lien dépasse la valeur par défaut du marchand.
- 03
Ou passez le URL par le API
Si votre site Web ou votre backend crée la caisse, passez le URL généré comme server_callback_url dans chaque requête.
- 04
Exécuter un paiement de contrôle
La vérification de la connexion locale est facultative. Pour vérifier votre propre configuration de portail Hutko, payez avec un nouvel order_id et vérifiez Commerce → Payments; pour joindre à une commande existante, passez son externalId.
Foire aux questions
- Est-ce la même intégration de Hutko pour les abonnements Obriym?
- C’est pas vrai. Cette intégration s’adresse aux paiements de vos clients. La facturation d’abonnement de Obriym est séparée et ne se mélange jamais avec votre journal de paiement.
- Est-ce que les paiements récurrents seront gérés ici?
- C’est pas vrai. L’intégration enregistre uniquement les résultats du paiement. La caisse, les frais, les remboursements et les paiements récurrents demeurent en Hutko.
- Et si Hutko n’envoyait pas d’email à l’acheteur ?
- Le paiement est toujours enregistré. L’e-mail ou le téléphone de l’acheteur est stocké seulement lorsque Hutko l’envoie réellement; diagnostics sûrs montrent seulement si ces champs étaient présents, jamais leurs valeurs.
- Un callback crée-t-il un ordre ?
- C’est pas vrai. Si order_id correspond à un order externalId existant, le paiement lui est attaché. Autrement, il est stocké séparément pour être recoupé.
- Où est le champ callback dans le portail Hutko ?
- Globally: Paramètres marchands → Paramètres de paiement → Callback serveur URL. Pour un lien de paiement, ouvrez ses fonctionnalités avancées; le URL dépasse la valeur de niveau marchand.
Connecter les états de paiement de Hutko
Enregistrer les paiements Hutko confirmés et les concilier avec les commandes sans créer de duplicatas.