Skip to main content
POST
Register a merchant and its locations

Authorizations

x-api-key
string
header
required

Role-scoped API key (admin, partner, merchant, auditor, readonly).

Query Parameters

partner_id
string<uuid>

Admin keys only; the partner to act for.

Body

application/json
merchant_name
string
required
Example:

"Space Coast Hardware"

external_id
string
required
Example:

"SCH-1"

locations
object[]
required
Minimum array length: 1
contact_email
string<email>
metadata
object

Response

Registered.

success
boolean
merchant
object