DEVELOPERS · API v1

Quickstart

Public documentation. Partner access through Sales.

Contact Sales

Documentation / Quickstart

After Sales provisions your credentials, connect from your server and complete this sequence.

1. Get an access token

export BASE_URL='https://rewallo.com'
curl "$BASE_URL/oauth/token" \
  -H 'Accept: application/json' \
  --data-urlencode 'grant_type=client_credentials' \
  --data-urlencode 'client_id=YOUR_CLIENT_ID' \
  --data-urlencode 'client_secret=YOUR_CLIENT_SECRET' \
  --data-urlencode 'scope=merchants:write members:write members:read stamps:write'

2. Create a merchant

curl -X PUT "$BASE_URL/api/partner/v1/merchants/shop_42" \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Accept: application/json' -H 'Content-Type: application/json' \
  -d '{"name":"Example Salon","program":{"threshold":8,"reward":"Free trim"}}'

3. Enroll a member

curl "$BASE_URL/api/partner/v1/members" \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Accept: application/json' -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: enroll-shop42-customer7' \
  -d '{"merchant_external_id":"shop_42","external_customer_id":"customer_7","name":"Example Customer"}'

4. Award a stamp

curl "$BASE_URL/api/partner/v1/stamps" \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Accept: application/json' -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: visit-100-stamp' \
  -d '{"member_id":"mem_123","count":1,"reason":"appointment.completed","source_ref":"visit_100"}'

Use returned identifiers

Examples use placeholder identifiers. Save the merchant_id and member_id returned by your own requests. Use the returned card_url for the customer card. Never expose your client secret or access token to browser code.

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