Tài khoản — đăng ký
Đăng ký trên site dealer Gommo tạo tài khoản thuộc domain đăng ký của dealer đó. Integrator nhúng signup trong app gọi upstream auth/register với credential merchant trên server — không đưa merchant token ra browser.
Site docs có luồng sẵn tại /vi/signup/ (cùng proxy gateway với Playground khi chạy npm run docs:stack).
Playground
Playground — System → Register API (test) khi chạy npm run docs:stack. Chỉ xem JSON; không lưu token, không đổi Connection. Domain do tenant dealer trên server (không có field trên form). Cần GOMMO_ACCESS_TOKEN và GOMMO_MANAGER_ID trong .env gateway.
Credential merchant
POST …/auth/register luôn dùng merchant access_token và manager_id trên server. Ops: POST /admin/users/register + x-admin-key; portal/self-host: POST /gateway/auth/register (JSON) — không phải curl Tier A với Bearer user.
Upstream register (server)
POST https://api.gommo.net/api/apps/go-mmo/auth/register
Content-Type: application/x-www-form-urlencoded
| Field | Bắt buộc | Ghi chú |
|---|---|---|
email | có | Email user mới |
password | có | Độ dài tối thiểu upstream (gateway ≥ 6) |
phone | có | Số điện thoại |
name | tùy | Tên hiển thị |
note | tùy | Ghi chú nội bộ |
domain | có | Domain đăng ký (dealer tenant) |
manager_id, ref, access_token, expired_time | có | Merchant / manager — chỉ server |
Thành công → JSON có access_token user mới. success: false hoặc HTTP ≥ 400 → lỗi.
→ Admin (server-only) — POST /admin/users/register
Mode B (gateway tùy chọn)
POST {gateway}/gateway/auth/register — không Bearer; body JSON như EN doc.
Server điền domain, merchant token, manager_id từ env và tenant. Thiếu env merchant → 503.
OpenAPI: openapi.yaml — /gateway/auth/register.
Xem Endpoint map và Deploy → Self-host (advanced).
→ Tài khoản — đổi mật khẩu · Chuyển credit · Thiết bị đăng nhập · Ticket hỗ trợ · Chương trình đối tác · Creator Rewards