DEVELOPERS · API v1

Members

Public documentation. Partner access through Sales.

Contact Sales

Documentation / Members

Customer identity is scoped to your client and merchant. The same external customer can have a separate membership at each business.

Enrollment endpoint

POST /api/partner/v1/members
Scope: members:write
Idempotency-Key: required
Success: 201 (created), 200 (updated)

Request fields

FieldRequiredFormat
merchant_external_idrequiredstring ≤ 64
external_customer_idrequiredstring ≤ 64
namerequiredstring ≤ 100
emailoptional, nullableemail ≤ 190
phoneoptional, nullablestring ≤ 32

Request body

{"merchant_external_id":"shop_42","external_customer_id":"customer_7","name":"Example Customer","email":"[email protected]","phone":"+355691234567"}

Enrollment response

{"member_id":"mem_123","external_customer_id":"customer_7","balance":0,"threshold":8,"card_url":"https://rewallo.com/card/EXAMPLE_BEARER_TOKEN"}

Contact updates

On upsert, omitted contact fields are retained. Explicit null clears a contact field. Balance reports the current stamp count. Treat card_url as a bearer credential; anyone with the link can view the card.

Read a member

GET /api/partner/v1/members/mem_123
Scope: members:read

{"member_id":"mem_123","name":"Example Customer","balance":2,"threshold":8,"rewards_available":0,"reward":"Free trim","card_url":"https://rewallo.com/card/EXAMPLE_BEARER_TOKEN","last_visit_at":"2026-10-24 12:00:00"}

Delete a member

DELETE /api/partner/v1/members/mem_123
Scope: members:write
Success: 202

{"deleted":true}

Deletion behavior

Deletion anonymizes contact and card details and removes the partner link. The old card link stops working. Loyalty history remains for accounting. Repeating deletion returns 404.

Your privacy

We use necessary storage for sign-in, security and preferences. No analytics or advertising trackers are enabled.

Necessary storage Always active
Keeps your session secure, remembers your language and stores your privacy choice.
Analytics and advertising
Not enabled. We do not use session replay or advertising cookies in this version.

This choice does not accept subscription terms or sign you up for marketing emails.

Legal and privacy centre