Une adresse de dépôt crypto unique pour chaque utilisateur

Pourquoi une adresse partagée ne suffit pas

Toute plateforme qui accepte la crypto se heurte au même mur, dans le même ordre, en général après le premier ticket de support sur un paiement introuvable.

• Une adresse unique vous donne un montant et un expéditeur, jamais celui de vos utilisateurs à qui il revient. Le rapprochement par montant casse dès que deux personnes envoient la même somme.
• Le contournement habituel consiste à tout regrouper puis à reverser plus tard — ce qui transforme une fonctionnalité de paiement en détention de l’argent d’autrui, la chose la plus lourde qu’une plateforme puisse assumer.
• Demander un mémo ou une référence fonctionne jusqu’à ce que quelqu’un l’oublie, et c’est alors un humain qui rapproche une blockchain à la main.

Un appel par utilisateur, une seule fois

Vous envoyez votre propre identifiant d’utilisateur. Vous recevez des adresses qui ne changent jamais : l’appel a lieu à l’inscription, et plus jamais ensuite.

1. 01

   Créez le client avec votre identifiant

   Transmettez l’identifiant existant de l’utilisateur dans `external_ref`. Unheld ne crée pas un identifiant que vous devriez ensuite stocker et faire correspondre — la fiche est indexée sur celui que votre base de données utilise déjà.

2. 02

   Conservez les adresses reçues

   La réponse contient les adresses de dépôt de cet utilisateur, dérivées de votre propre portefeuille. Elles sont permanentes : vous pouvez les afficher, les mettre dans un QR code, ou laisser l’utilisateur les enregistrer et envoyer depuis n’importe où.

3. 03

   Créditez le compte à l’arrivée du webhook

   Un paiement vers cette adresse est rattaché au client auquel elle appartient, et la notification vous renvoie votre propre `externalRef`. Votre application crédite un identifiant qu’elle connaît déjà, sans rapprocher de montants ni lire une chaîne.

L’appel réel

Requête

curl -X POST https://api.unheld.io/api/v1/customers \
  -H "Authorization: Bearer $UNHELD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "external_ref": "user_8412",
    "label": "Ada Lovelace",
    "supported_assets": ["ETH", "USDC"],
    "evm": true
  }'

Réponse

{
  "id": "c7f1…",
  "external_ref": "user_8412",
  "label": "Ada Lovelace",
  "evm_address": "0x…",
  "supported_assets": ["ETH", "USDC"],
  "receive_method": "auto"
}

Nécessite une clé d’API avec le scope `customers:write` ; les relire demande `customers:read`. Les adresses pour chaque chaîne sur laquelle un utilisateur peut payer sont disponibles via `GET /api/v1/customers/:id/addresses`.

Comment un paiement retrouve son utilisateur

Les factures peuvent aussi être liées à un client via `customerId`, de sorte qu’un paiement ponctuel et une adresse de dépôt permanente se rattachent au même utilisateur, dans votre tableau de bord comme dans vos webhooks.

Où se trouve réellement l’argent

Ce que cela ne vous dit pas, c’est si votre plateforme, elle, détient des fonds pour ses utilisateurs. C’est probablement le cas si les paiements arrivent sur des adresses que vous contrôlez et que vous devez cette valeur à vos utilisateurs. C’est une question propre à votre montage et à votre juridiction, à laquelle nous ne pouvons pas répondre à votre place — faites-vous conseiller. Nous ne pouvons affirmer que notre côté : l’argent ne transite jamais par Unheld.

Concevoir avec

Chacun de ces points est plus facile à anticiper maintenant qu’à découvrir en production.

• Chaque adresse d’utilisateur dérive d’un seul portefeuille : le vôtre. Vous n’avez donc qu’une phrase de récupération à protéger, pas une par utilisateur — et les fonds ne sont pas cloisonnés par utilisateur au niveau des clés.
• Une adresse permanente est réutilisée par conception, et c’est ce qui permet le rattachement. Cela signifie aussi que l’historique des paiements d’un utilisateur à votre intention peut être retracé et relié sur la blockchain par quiconque connaît son adresse.
• L’adresse d’un utilisateur est fixe par famille de chaînes : la même adresse EVM reçoit sur tous les réseaux EVM que vous avez activés. Activer une nouvelle chaîne n’oblige pas à réémettre les adresses.
• Supprimer un client arrête la surveillance de son adresse ; cela ne déplace pas — et ne peut pas déplacer — ce qui y a déjà été envoyé. L’argent qui arrive après la suppression reste le vôtre, mais rien ne vous en avertira.

Questions