ข้ามไปที่เนื้อหา

Member Registration (Register)

ใช้สำหรับลงทะเบียนผู้ใช้งานรายใหม่จากระบบภายนอกเข้ามาเป็นสมาชิกของ Card2U

  • Endpoint: /openapi/v1/user/register
  • Method: POST
  • Authentication Required: API Key (X-API-Key)

Request Body Parameters

Parameter Type Required Description Example
phone string Yes เบอร์โทรศัพท์เคลื่อนที่ของสมาชิก (ใช้เป็น Key ในการระบุตัวตน/เข้าสู่ระบบ) "0812345678"
first_name string Yes ชื่อจริงของสมาชิก "สมชาย"
last_name string Yes นามสกุลของสมาชิก "ใจดี"
email string No อีเมลของสมาชิก "somchai@example.com"
reference string No รหัสอ้างอิงสมาชิกจากระบบภายนอก (External ID) "EXT-99812"

Request Example

{
  "phone": "0812345678",
  "first_name": "สมชาย",
  "last_name": "ใจดี",
  "email": "somchai@example.com",
  "reference": "EXT-99812"
}

Response Examples

{
  "success": true,
  "data": {
    "member_id": "M-20260708001",
    "card_number": "100200300400",
    "phone": "0812345678",
    "first_name": "สมชาย",
    "last_name": "ใจดี",
    "email": "somchai@example.com",
    "status": "active",
    "initial_points": 0,
    "created_at": "2026-07-08T10:30:00Z"
  },
  "message": "Member registered successfully."
}

{
  "success": false,
  "error": {
    "code": "DUPLICATE_PHONE_NUMBER",
    "message": "เบอร์โทรศัพท์นี้ถูกใช้งานในการสมัครสมาชิกไปแล้ว",
    "details": {
      "phone": ["The phone number has already been taken."]
    }
  }
}