Envoyer à des non-clients
Un partenaire vous transmet une liste de prospects. Un salon vous confie 300 invitations presse. Ces personnes n’ont pas de carte de fidélité chez vous. Vous leur envoyez quand même un coupon ou un billet, sans les inscrire d’abord.
Client ou non-client ?
| Client | Non-client | |
|---|---|---|
| Fiche dans le wallet | Oui, créée avant (POST/clients) | Non |
| Identifié par | clientId | firstName, lastName, email (obligatoires), phoneNumber |
| Cas typique | Coupon anniversaire, récompense de palier | Campagne prospects, invitations, partenaires |
Par type de pass
| Pass | Endpoint | Comment |
|---|---|---|
| Coupon | POST/coupons/{id}/passes/send | Dans clients, mettez un clientId pour un client, ou prénom, nom, email pour un non-client. Les deux peuvent cohabiter dans le même envoi. |
| Événement | POST/events/{id}/passes | Prénom, nom, email, et la place (leftRow, centerRow, rightRow). |
| Événement, en masse | POST/events/{id}/passes/bulk | Même chose, jusqu’à 5 000 billets, en asynchrone. |
| Transport, hôtel | POST/transits/{transitId}/passes, POST/hotels/{id}/passes | Ces passes s’émettent toujours à partir des coordonnées du voyageur. |
Exemple : un coupon à des prospects
Chaque destinataire peut avoir sa propre valeur, description, date d’expiration, code promo ou code-barres. Ici, -10 % pour un contact froid, -20 % pour un contact chaud :
- curl
- SDK Node.js
- nodejs
- php
- python
- java
- csharp
- go
- ruby
- CURL
curl -L 'https://api-v2.test.eldowallet.fr/coupons/$COUPON_ID/passes/send' \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' \
-H 'x-lang: fr' \
-H 'Authorization: Bearer <token>' \
--data-raw '{
"webhookUrl": "https://crm.example.com/hooks/eldo",
"clients": [
{
"firstName": "Alan",
"lastName": "Jason",
"email": "alan@example.com",
"value": "-10 %"
},
{
"firstName": "Inès",
"lastName": "Roux",
"email": "ines@example.com",
"value": "-20 %",
"barcode": "PROMO-0002"
}
]
}'
L’envoi est une opération en masse : la réponse donne l’identifiant de l’opération, à suivre avec GET/bulk-operations/{operationId} ou via webhookUrl.
Coordonnées manquantes
Sans clientId, prénom, nom et email sont obligatoires. Sinon : MISSING_RECIPIENT_DETAILS_FOR_NON_CLIENT.
Bonnes pratiques
- Ayez le consentement. Envoyer un email ou un SMS à un non-client reste de la prospection. Vérifiez la base légale de votre fichier.
- Un code-barres par bon si votre caisse doit savoir quel bon a été utilisé.
- Mesurez. Suivez l’usage des coupons avec GET
/coupons/{id}/passes/stats.