đ± Encaissement mobile sur l'app (Tap to Pay) - Impacts sur l'API
L'encaissement mobile grùce à la technologie Tap to Pay sur l'app HelloAsso est désormais disponible. Cette fonctionnalité permet aux associations d'encaisser des paiements par carte sans contact directement depuis leur smartphone, sans terminal de paiement.
Voici le détail des impacts sur l'API.
Nouveaux paiements dans vos flux de données
Les paiements Tap to Pay apparaissent dans vos appels aux routes existantes (GET /payments, GET /orders).
Pour les identifier ou les filtrer, plusieurs points de repĂšre :
1. Moyen de paiement
Le champ paymentMeans retourne card, identique Ă un paiement CB classique, Apple Pay ou Google Pay.
2. Formulaire associé
Tous les paiements Tap to Pay sont rattachés à un formulaire de l'association de type shop, ayant pour slug solde-taptopay. Ce formulaire est auto généré par HelloAsso et en read only.
Vous pouvez les récupérer via :
GET /v5/organizations/{organizationSlug}/forms/shop/solde-taptopay/payments
3. DĂ©signation de l'article
Le bénévole peut qualifier chaque encaissement (ex : "Boisson", "Adhésion", "Entrée"). Cette information est disponible dans l'objet displayData du paiement, au niveau du champ itemName.
Données payeur vides
Le Tap to Pay ne permet pas la saisie des coordonnées payeur, les champs suivants prennent ces valeurs :
| Champ | Valeur |
|---|---|
firstName | N/A |
lastName | N/A |
email | N/A |
dateOfBirth | (vide) |
Action recommandéeVérifiez que vos traitements gÚrent correctement les valeurs
N/Adans les champs payeur.
Notifications
Les notifications de paiement sont envoyées de maniÚre standard. En revanche, aucun email transactionnel n'est adressé au payeur.
Remboursements
Les paiements effectués via Tap to Pay ne sont pas remboursables.
Pour en savoir plus, c'est par ici.