API สั่งซื้อด้วย AI

หลังจากลูกค้ายืนยันคำสั่งซื้อในบทสนทนาแล้ว เราจะเรียก API ของคุณเพื่อสร้างคำสั่งซื้อที่รอการชำระเงิน และส่งลิงก์ชำระเงินให้กับลูกค้า

เมื่อลูกค้าเลือกสินค้าในบทสนทนาแล้ว AI จะร่างคำสั่งซื้อให้ลูกค้ายืนยัน หลังจากลูกค้ายืนยัน เราจะขอให้ระบบของคุณสร้างคำสั่งซื้อที่รอชำระเงิน และส่งลิงก์ชำระเงินที่คุณส่งกลับมาให้ลูกค้า เราไม่จัดเก็บคำสั่งซื้อและไม่จัดการเงินค่าสินค้า

ในหน้าหลังบ้าน “การตั้งค่าบอท” ให้กรอก API สำหรับสั่งซื้อ (หากไม่กรอก AI จะไม่สามารถสั่งซื้อได้) และสามารถกรอก ที่อยู่หน้าเข้าสู่ระบบ เพิ่มเติมได้: เมื่อลูกค้าที่ยังไม่ได้เข้าสู่ระบบต้องการสั่งซื้อ ปุ่ม “เข้าสู่ระบบ” จะแสดงในหน้าต่างแชท

ข้อกำหนดเบื้องต้น:

เฉพาะลูกค้าที่เข้าสู่ระบบแล้วเท่านั้นที่สั่งซื้อได้ user_id มาจาก user_token ที่คุณออกให้ (ดู ระบุลูกค้าที่เข้าสู่ระบบ)
สินค้าต้องซิงก์ผ่าน Open API (ดู ฐานความรู้และสินค้า); สินค้าที่มีตัวเลือกสินค้าต้องมี variants[].sku และเมื่อเราสั่งซื้อ จะส่ง sku กลับไปให้คุณตามเดิม

ลูกค้ายืนยันอย่างไร:

หน้าต่างแชทบนเว็บ: หลังจาก AI ร่างแล้ว จะแสดงการ์ดคำสั่งซื้อ ลูกค้าต้องคลิก “ยืนยันการสั่งซื้อ” จึงจะสร้างคำสั่งซื้อ เมื่อสร้างเสร็จจะปรากฏปุ่ม “ไปชำระเงิน” บนการ์ด
ช่องทางที่ส่งได้เฉพาะข้อความ เช่น WeChat Mini Program: AI จะส่งสรุปคำสั่งซื้อให้ลูกค้า ลูกค้าต้องตอบ “ยืนยัน” จึงจะสร้างคำสั่งซื้อ เมื่อสร้างเสร็จจะส่งทางเข้าชำระเงิน (ดู mp_path ด้านล่าง)

คำขอ

ใช้ URL เดียวกัน โดยใช้ mode เพื่อแยกระหว่างการประเมินราคาและการสร้างคำสั่งซื้อ วิธีลงนามและตรวจสอบลายเซ็นเหมือนกับ API สำหรับตรวจสอบคำสั่งซื้อ และมี timeout 10 วินาที

POST {你的下单接口}
Content-Type: application/json
X-AICS-Timestamp: 1761120000
X-AICS-Signature: v1=<hex>

{
  "mode": "quote",
  "request_id": "chk_3f2a9c...",
  "user_id": "u_123",
  "conversation_id": "b3c1...",
  "channel": "widget",
  "language": "en",
  "country": "US",
  "items": [{"product_id": "w1", "sku": "w1-black", "qty": 1}]
}

ฟิลด์	คำอธิบาย
`mode`	`quote`: คำนวณราคาเท่านั้น (ส่วนลด ค่าจัดส่ง ภาษี), ไม่สร้างคำสั่งซื้อและไม่จองสต็อก; `create`: สร้างคำสั่งซื้อที่รอชำระเงิน
`request_id`	การประเมินราคาและการสร้างคำสั่งซื้อของการยืนยันคำสั่งซื้อเดียวกันใช้ค่าเดียวกัน เมื่อ `create` ได้รับ `request_id` ซ้ำ ต้องคืนคำสั่งซื้อเดียวกัน การลองใหม่ของเราและการคลิกซ้ำของลูกค้าจะใช้ค่านี้เพื่อป้องกันการสั่งซื้อซ้ำ
`user_id`	ลูกค้าที่เข้าสู่ระบบ สามารถสร้างคำสั่งซื้อให้ลูกค้ารายนี้เท่านั้น
`channel`	`widget` / `wechat_mp` / `api`
`language`、`country`	ภาษาของลูกค้าและประเทศจาก IP อาจเป็น `null` ใช้เลือกสกุลเงินที่ใช้ชำระและคำนวณภาษีได้
`items[].product_id` / `sku`	`external_id` ของสินค้าและ `sku` ของตัวเลือก; สินค้าที่ไม่มีตัวเลือก `sku` จะเป็น `null`

การตอบกลับ

ประเมินราคาสำเร็จ:

{
  "status": "quoted",
  "currency": "USD",
  "goods_amount": "399.00",
  "discount": "20.00",
  "discounts": [{"label": "新客券", "amount": "20.00"}],
  "shipping_fee": "0",
  "tax": "0",
  "total": "379.00"
}

สร้างคำสั่งซื้อสำเร็จ:

{
  "status": "created",
  "order_no": "T2026102300001",
  "pay_url": "https://shop.example.com/pay?orderno=T2026102300001",
  "mp_path": "pages/order/pay?orderno=T2026102300001",
  "expires_at": "2026-10-23T12:30:00Z",
  "currency": "USD",
  "goods_amount": "399.00",
  "discount": "20.00",
  "shipping_fee": "0",
  "tax": "0",
  "total": "379.00"
}

ไม่สามารถสั่งซื้อได้:

{"status": "rejected", "code": "OUT_OF_STOCK", "message": "这款黑色暂时缺货"}

จำนวนเงินทั้งหมดใช้สตริง total และ currency จำเป็นต้องมี ฟิลด์อื่นสามารถละเว้นได้; discounts แสดงได้สูงสุด 5 รายการ
pay_url คือลิงก์ชำระเงินบนเว็บ ต้องเป็น https; เมื่อกำหนดรายการโดเมนที่อนุญาตในหน้า “การเชื่อมต่อ” แล้ว ลิงก์ต้องอยู่บนโดเมนที่อนุญาตหรือซับโดเมนของโดเมนนั้นด้วย มิฉะนั้นจะไม่แสดง
mp_path คือพาธหน้าชำระเงินใน Mini Program ซึ่งในช่องทาง WeChat จะส่งให้ลูกค้าเป็นการ์ด Mini Program (ภาพปกใช้รูปสินค้าชิ้นแรก); หากไม่มี mp_path จะส่ง pay_url ต้องมีอย่างน้อยหนึ่งอย่าง
expires_at คือเวลาสิ้นสุดการชำระเงิน และจะแสดงบนการ์ด
code ค่าที่เลือกได้: OUT_OF_STOCK、SKU_UNAVAILABLE、REGION_UNAVAILABLE、NOT_LOGGED_IN、LIMIT、OTHER message จะแสดงให้ลูกค้าเห็นโดยตรง โปรดใช้ถ้อยคำที่ลูกค้าเข้าใจได้
หากไม่ต้องการทำการประเมินราคา สามารถตอบ quote ด้วย {"status": "unsupported"} การ์ดจะประเมินราคาตามราคาในแคตตาล็อกสินค้า และระบุว่า “จำนวนเงินสุดท้ายเป็นไปตามหน้าชำระเงิน”
เมื่อ create ส่งคืนสถานะที่ไม่ใช่ 200 หรือรูปแบบไม่ถูกต้อง การยืนยันคำสั่งซื้อจะยังคงอยู่ และลูกค้าสามารถคลิกอีกครั้งได้; โปรดตรวจสอบให้แน่ใจว่า request_id ที่ซ้ำกันจะไม่สร้างคำสั่งซื้อใบที่สอง

ข้อจำกัด: การยืนยันคำสั่งซื้อมีอายุ 30 นาที การร่างรายการใหม่ในบทสนทนาเดียวกันจะทำให้รายการเดิมเป็นโมฆะ; หนึ่งคำสั่งซื้อมีสินค้าได้สูงสุด 10 ชนิด ชนิดละไม่เกิน 20 ชิ้น; ภายใน 24 ชั่วโมงในบทสนทนาเดียวกันสามารถสร้างคำสั่งซื้อได้สูงสุด 5 ใบ

หน้านี้มีประโยชน์ไหม?

อัปเดตล่าสุด: 31 ตุลาคม 2569