Bons
Un registre partagé de codes qu'un marchand émet et que chacune de ses applications peut dépenser.
Utiliser un bon ne déplace aucun argent
C'est le point à lire deux fois. Utiliser un bon n'écrit rien au grand livre et ne déplace aucun solde. Cela autorise l'application APPELANTE à créditer son propre compte, exactement une fois, d'un montant indiqué — le crédit vous revient.
Chaque route est limitée au marchand derrière la clé API et à l'environnement de cette clé : un code sandbox ne vaut rien en Live et aucun marchand ne peut lire ou dépenser les codes d'un autre.
Le code est un titre au porteur
Les codes en clair sont renvoyés à l'émission du lot et jamais ensuite. Baraka Pay les stocke hachés ; aucun endpoint ne relit un code. Traitez la réponse d'émission comme un mot de passe à usage unique.
L'utilisation est à usage unique sous concurrence : deux utilisations simultanées d'un même code produisent exactement une réussite et un refus, pas deux crédits.
Endpoints
Émettre un lot, les lister, valider un code sans le dépenser, l'utiliser, demander la livraison d'un lot à un destinataire, ou annuler un code non dépensé.