Members

Members (buyers/recipients) for payments. (node_id, external_id) must be unique per node.

Authentication: Bearer token required.

---

Create Member

Endpoint: POST /api/v1/members

Request Body

Field	Type	Required	Validation	Description
node_id	string	Yes	UUID	Node UUID
external_id	string	Yes	1–255 chars	External identifier (unique per node)
name	string	Yes	1–255 chars	Member name
surname	string	No	max 255	Surname
email	string	No	max 255, email	Email
phone	string	No	max 50	Phone
identity_number	string	No	max 50	Identity number
tax_office	string	No	max 255	Tax office
tax_number	string	No	max 50	Tax number
address	string	No	—	Address
district	string	No	max 255	District
city	string	No	max 255	City
country	string	No	max 10	Country
contact_name	string	No	max 255	Contact name
locale	string	No	max 10	Locale

Response — 201 Created

Returns full member object including id, created_at.

Status	Description
404	Node not found
409	Member with node_id+external_id already exists

---

List Members

Endpoint: GET /api/v1/members

Query Parameters

Parameter	Type	Required	Default	Description
node_id	string	Yes	—	Node UUID
page	int	No	1	Page number
per_page	int	No	10	Items per page (max 100)

Response — 200 OK

Paginated list with items, page, per_page, total.

---

Get Member by ID

Endpoint: GET /api/v1/members/{id}

Path Parameters

Parameter	Type	Required	Description
id	string	Yes	Member UUID

Response — 200 OK

Full member object including updated_at.

Status	Description
404	Member not found

---

Update Member

Endpoint: PUT /api/v1/members/{id}

Only provided fields are updated. External ID and node are immutable.

Path Parameters

Parameter	Type	Required	Description
id	string	Yes	Member UUID

Request Body

Same fields as Create (all optional except id in path).

Response — 200 OK

Returns updated member object.

Status	Description
404	Member not found

---

Delete Member

Endpoint: DELETE /api/v1/members/{id}

Soft-deletes a member.

Path Parameters

Parameter	Type	Required	Description
id	string	Yes	Member UUID

Response — 204 No Content

Status	Description
404	Member not found