API Pesanan AI

Selepas pelanggan memilih produk dalam perbualan, AI merangka pesanan untuk pengesahan pelanggan; selepas pelanggan mengesahkan, Yinke meminta sistem anda mencipta pesanan menunggu pembayaran dan memberikan pautan pembayaran yang anda kembalikan kepada pelanggan. Yinke tidak menyimpan pesanan dan tidak mengendalikan dana pembayaran.

Di panel pentadbir, di "Tetapan Bot", isikan API pesanan (jika tidak diisi, AI tidak boleh membuat pesanan), dan anda juga boleh mengisi alamat halaman log masuk: apabila pelanggan yang belum log masuk ingin membuat pesanan, butang "Log masuk" akan muncul dalam tetingkap sembang.

Prasyarat:

• Hanya pelanggan yang log masuk boleh membuat pesanan; user_id berasal daripada user_token yang anda keluarkan (lihat Mengenal pasti pelanggan yang log masuk).
• Produk perlu disegerakkan melalui API terbuka (lihat Pangkalan pengetahuan dan produk); produk yang mempunyai varian mesti membawa variants[].sku; semasa membuat pesanan, kami menghantar sku kepada anda tanpa perubahan.

Bagaimana pelanggan mengesahkan:

• Tetingkap sembang web: selepas AI merangka, kad pesanan dipaparkan; pesanan hanya dicipta selepas pelanggan menekan "Sahkan pesanan", dan selepas pesanan dicipta, butang "Pergi bayar" muncul pada kad.
• Saluran yang hanya boleh menghantar teks seperti WeChat Mini Program: AI menghantar ringkasan pesanan kepada pelanggan; pesanan hanya dicipta selepas pelanggan membalas "Sahkan", dan selepas pesanan dicipta, akses pembayaran dihantar (lihat mp_path di bawah).

Permintaan

Alamat yang sama; bezakan sebut harga dan penciptaan pesanan mengikut mode. Kaedah tandatangan dan pengesahan tandatangan adalah sama seperti API pertanyaan pesanan, dengan tamat masa 10 saat.

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}]
}

Respons

Sebut harga berjaya:

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

Pesanan berjaya dicipta:

{
  "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"
}

Tidak dapat membuat pesanan:

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

• Semua amaun menggunakan rentetan. total dan currency wajib diisi, selebihnya boleh ditinggalkan; discounts memaparkan maksimum 5 item.
• pay_url ialah pautan pembayaran web dan mesti https; jika senarai putih domain dikonfigurasikan pada halaman "Integrasi", ia juga mesti berada pada domain dalam senarai putih atau subdomainnya, jika tidak ia tidak akan dipaparkan.
• mp_path ialah laluan halaman pembayaran dalam Mini Program; dalam saluran WeChat, ia akan dihantar kepada pelanggan sebagai kad Mini Program (imej muka depan menggunakan imej produk pertama); jika tiada mp_path, pay_url akan dihantar. Sekurang-kurangnya satu daripadanya diperlukan.
• expires_at ialah tarikh akhir pembayaran dan akan dipaparkan pada kad.
• Nilai yang dibenarkan untuk code: OUT_OF_STOCK, SKU_UNAVAILABLE, REGION_UNAVAILABLE, NOT_LOGGED_IN, LIMIT, OTHER. message akan dipaparkan terus kepada pelanggan; sila gunakan bahasa yang mudah difahami pelanggan.
• Jika tidak mahu menyediakan sebut harga, anda boleh mengembalikan {"status": "unsupported"} untuk quote; kad akan membuat anggaran berdasarkan harga dalam katalog produk dan menyatakan "Jumlah akhir tertakluk pada halaman pembayaran".
• Apabila create mengembalikan status bukan 200 atau format tidak betul, pengesahan pesanan dikekalkan dan pelanggan boleh menekan sekali lagi; pastikan request_id yang berulang tidak mencipta pesanan kedua.

Had: Pengesahan pesanan sah selama 30 minit; merangka pengesahan baharu dalam perbualan yang sama akan membatalkan yang lama; satu pesanan boleh mengandungi maksimum 10 jenis produk dan maksimum 20 unit bagi setiap jenis; dalam perbualan yang sama, maksimum 5 pesanan boleh dicipta dalam tempoh 24 jam.