Seller Orchestra Internal API Mapping

Customer Users

Customer management, profile operations, and CSV export functionality

3-Layer Architecture

Seller API Gateway Seller Admin (Orchestra) Customer Service

Token validation happens at Gateway level via JWT verification

Fetch Customers (List)

List and filter customers with pagination and sorting

GET
GET /merchant/api/v1/domains/:domain_id/customers
Query Params: sort, order, first_name, last_name, email, bool_email_verified, bool_phone_verified, num_total_orders, gte_total_order_amount, page, size
1 GET /api/customer_users?domain_id=:domain_id&... Customer Service
Response Fields:
id, tenant_id, email, phone, registration_source, enabled, approved, email_verified, phone_verified, first_name, last_name, group_id, group_name, last_active_on, total_orders, total_order_amount, status

Get Customer

Retrieve detailed customer profile including group information

GET
GET /merchant/api/v1/domains/:domain_id/customers/:id
1 GET /api/customer_users/:id Customer Service
2 GET /api/addresses?customer_id=:id Customer Service (optional)

Create Customer

Create a new customer under the domain

POST
POST /merchant/api/v1/domains/:domain_id/customers
Body: email, registration_source, enabled, approved, email_verified, phone_verified, first_name, last_name, tenant_id
1 POST /api/customer_users Customer Service
2 POST /api/events/log Util Service

Update Customer

Update customer profile information

PUT
PUT /merchant/api/v1/domains/:domain_id/customers/:id
Body: first_name, last_name, enabled, approved, group_id (partial update)
1 PUT /api/customer_users/:id Customer Service
2 POST /api/events/log Util Service

Delete Customer

Delete a customer from the domain

DELETE
DELETE /merchant/api/v1/domains/:domain_id/customers/:id
1 DELETE /api/customer_users/:id Customer Service
2 POST /api/events/log Util Service

Export Customers (CSV)

Export customers to CSV format for reporting

GET
GET /merchant/api/v1/domains/:domain_id/customers/csv
Query Params: customer_ids (comma-separated), email
1 GET /api/customer_users?domain_id=:domain_id&... Customer Service
Response (Content-Type: text/csv):
id,tenant_id,email,registration_source,enabled,approved,email_verified,phone_verified,group_id,group_name,last_active_on,total_orders,total_order_amount

Documentation Notes

Customer Users are domain-scoped. Token validation happens at the Seller API Gateway level via JWT verification.

registration_source values: EMAIL_PASSWORD, GOOGLE, FACEBOOK, PHONE, etc.
Open full text mapping