Send to non-customers

A partner hands you a list of prospects. A trade fair gives you 300 press invitations. These people have no loyalty card with you. You still send them a coupon or a ticket, without signing them up first.

Customer or non-customer?

	Customer	Non-customer
Record in the wallet	Yes, created beforehand (POST/clients)	No
Identified by	clientId	firstName, lastName, email (required), phoneNumber
Typical case	Birthday coupon, tier reward	Prospect campaign, invitations, partners

By pass type

Pass	Endpoint	How
Coupon	POST/coupons/{id}/passes/send	In clients, give a clientId for a customer, or first name, last name and email for a non-customer. Both can be mixed in one send.
Event	POST/events/{id}/passes	First name, last name, email, and the seat (leftRow, centerRow, rightRow).
Event, in bulk	POST/events/{id}/passes/bulk	Same, up to 5,000 tickets, asynchronous.
Transit, hotel	POST/transits/{transitId}/passes, POST/hotels/{id}/passes	These passes are always issued from the traveller’s contact details.

Example: a coupon for prospects

Each recipient can have their own value, description, expiry date, promo code or barcode. Here, 10% for a cold lead, 20% for a warm one:

POST/coupons/{id}/passes/sendTry it →

• 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: en' \
-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"
    }
  ]
}'

The send is a bulk operation: the response gives the operation id, to track with GET/bulk-operations/{operationId} or via webhookUrl.

Missing details

Without clientId, first name, last name and email are required. Otherwise: MISSING_RECIPIENT_DETAILS_FOR_NON_CLIENT.

Best practices

• Have consent. Emailing or texting a non-customer is still prospecting. Check the legal basis for your list.
• One barcode per voucher if your till needs to know which voucher was used.
• Measure. Track coupon usage with GET/coupons/{id}/passes/stats.

Go further

• Events use case
• Retail use case
• Email or SMS not received