Configurer les callbacks des wallets dédiés : de la création au crédit
Acheminer chaque recharge
Un wallet dédié associe une adresse de réception persistante à un membre ou à un identifiant métier. Définir son URL de callback lors de la création manuelle dirige les notifications de paiement confirmé vers le bon récepteur. Cela ne modifie ni l’adresse de réception ni la propriété des fonds.
Renseigner l’URL à la création
Dans la liste des wallets du marchand, choisissez Créer un wallet, sélectionnez un actif et un réseau pris en charge, puis Wallet dédié. Renseignez l’identifiant du membre (bind_key) et l’URL de callback facultative avec une adresse HTTPS publique complète. Vérifiez le réseau et l’actif avant de valider.
Comprendre les valeurs par défaut
L’URL dédiée sert aux notifications de ce wallet. Un champ vide ne définit aucune nouvelle cible propre au wallet ; le routage suit alors les paramètres de l’ordre et du callback par défaut du marchand. Si vous utilisez ce dernier, vérifiez qu’il est activé et correct. Enregistrer une URL ne prouve pas que le récepteur traite les notifications.
Vérifier et créditer une seule fois
Conservez le lien entre membre, adresse, réseau et actif. Vérifiez la signature avec callbackSecret selon la documentation, puis contrôlez l’ordre, l’actif, le réseau et le montant avant de créditer. Une contrainte d’unicité et une transaction en base doivent empêcher les crédits en double. L’adresse du wallet ne constitue pas une clé unique par dépôt.
Tester le parcours complet
Vérifiez l’URL enregistrée, la livraison, la signature, le crédit et la reprise après échec. En production, utilisez HTTPS public. Réutiliser un bind_key existant peut renvoyer le wallet initial ; le recréer ne met pas sa configuration à jour. Vérifiez ses paramètres actuels.
Conserver une piste de contrôle
Gardez le numéro d’ordre, le hash de transaction, le résultat du callback et l’écriture de crédit. Confirmation du transfert, livraison du callback et mise à jour du solde sont des étapes distinctes à rapprocher en cas d’anomalie.
Solution d’adresses dédiées · Documentation API · Offres et frais