Notifications signées
Des livraisons que vous pouvez vérifier de deux façons indépendantes, rejouer vous-même depuis le tableau de bord, et recevoir sur une boîte intégrée si vous n’avez encore nulle part où héberger un point de terminaison.
Tout développeur dont le système doit réagir quand l’argent bouge : systèmes de commandes, plateformes scolaires, outils comptables, systèmes de livraison.
Fait partie de la plateforme elle-même : présent partout où BitriPay tourne.
Le problème
Interroger en boucle est coûteux, tardif et fragile. Les notifications ne résolvent cela que si vous pouvez distinguer une vraie d’une fausse, et seulement si une livraison qui échoue pendant que votre serveur redémarre n’est pas simplement perdue.
Comment cela fonctionne
- Enregistrez un point de terminaison et choisissez les événements qui vous intéressent.
- Vérifiez la signature à l’arrivée, répondez vite, et faites votre travail ensuite.
- Dédupliquez sur l’identifiant d’événement, car la livraison est au moins une fois par conception.
- Rejouez ce que vous voulez depuis le tableau de bord quand vous en avez besoin.
Ce que vous pouvez vérifier
Des faits sur la plateforme en fonctionnement, pas des adjectifs. Chacun est visible dans le produit, dans la référence de l’API ou dans le grand livre.
- Deux signatures par livraison : un HMAC-SHA256 sur le corps horodaté avec le secret de votre point de terminaison, et une signature Ed25519 du registre de clés de la plateforme.
- Les reprises suivent un calendrier publié sur 24 heures ; les livraisons ne sont pas abandonnées parce que votre serveur redémarrait.
- Chaque événement porte un identifiant : une livraison répétée peut être reconnue et ignorée.
- Une boîte de réception intégrée reçoit les événements d’un compte qui n’a encore nulle part où héberger un point de terminaison : l’intégration peut être construite avant le serveur.
Ce que cela coûte
Inclus. Il n’y a pas de frais par livraison.
Questions
Pourquoi « au moins une fois » et pas « exactement une fois » ?
Parce que la livraison « exactement une fois » sur un réseau n’existe pas, et qu’un prestataire qui la revendique décrit autre chose. Chaque événement a un identifiant ; dédupliquez dessus et vous obtenez un traitement exactement une fois, qui est ce que vous vouliez vraiment.
Mon serveur est tombé une heure. Qu’ai-je perdu ?
Rien de ce qui s’est produit dans la fenêtre de reprise. Les livraisons sont réessayées selon un calendrier publié sur 24 heures, et vous pouvez tout rejouer ensuite depuis le tableau de bord.
Je n’ai pas encore construit mon serveur.
Utilisez la boîte de réception intégrée. Les événements de votre compte arrivent quelque part où vous pouvez les lire : vous voyez la forme exacte d’un vrai événement avant d’écrire une ligne de code de traitement.
À lire ensuite
L’API de la passerelle
Une API de paiement dont la documentation est produite à partir de la même table qui sert les requêtes : la référence ne peut donc jamais décrire un point de terminaison que la plateforme n’a pas.
Comptes connectés
Créez les comptes marchands de vos clients par API, encaissez pour eux avec votre propre clé, gardez votre commission — et transmettez le compte dès qu’ils sont prêts, clés et historique intacts.