Skip to main content
The Create Merchant endpoint creates a new merchant account. Merchants are the top-level container for invoices, balances, API keys, and settings in IteraPay. You must authenticate with a Bearer token — API keys cannot be used to create new merchants. POST /merchants

​
Authentication

Requires a Bearer token (Authorization: Bearer <token>). API key authentication is not accepted for this endpoint.

​
Request body

​
name
string
required
The display name for the new merchant. This name appears in the dashboard and on invoices.

​
Response fields

A 201 Created response is returned on success.
​
id
string
required
The UUID of the newly created merchant.

​
Example request

curl --request POST \
  --url https://api.iterapay.com/merchants \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "My Store"
  }'

​
Example response

{
  "id": "b0fcc813-a7ce-4bbc-932f-dbef6f59ca7f"
}

​
Error responses

StatusDescription
400Invalid request body. The detail field describes the validation error.
401Missing or invalid Bearer token.
403Valid credentials but insufficient permissions to create a merchant.