DEVELOPERS · API v1

Merchants

Public documentation. Partner access through Sales.

Contact Sales

Documentation / Merchants

Create or update a partner-managed business using your stable external identifier. Updates return the same merchant_id.

Endpoint

PUT /api/partner/v1/merchants/{external_id}
Scope: merchants:write
Success: 201 (created), 200 (updated)

Request fields

FieldRequiredFormat
external_idpath, required[A-Za-z0-9._-], 1–64
namerequiredstring ≤ 120
program.thresholdrequiredinteger 3–30
program.rewardrequiredstring ≤ 100
program.brand_coloroptionalstring ≤ 20
countryoptionalstring, 2
timezoneoptionalstring ≤ 80

Request body

{"name":"Example Salon","program":{"threshold":8,"reward":"Free trim","brand_color":"#9FC94D"}}

Success response

{"merchant_id":"mch_42","external_id":"shop_42","name":"Example Salon","slug":"example-salon-abc123","threshold":8,"reward":"Free trim","enroll_url":"https://rewallo.com/join/example-salon-abc123"}

Merchant ownership

External merchant identifiers belong to your partner client. Partner-managed businesses receive loyalty access under the partner arrangement. Commercial terms and limits must be agreed with Sales.

Metadata limitation

The country and timezone fields are accepted but are not currently stored or returned. Do not rely on them for scheduling or localization.

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