Bỏ qua để đến nội dung

CRM, Commerce, Bookings & Privacy

  • POST /v1/customer-upserts upsert theo {namespace, external_id}.
  • Không bao giờ tự động gộp khách hàng mới chỉ vì trùng SĐT/email chưa xác minh; hỗ trợ gộp tường minh POST /v1/customer-merges (hỗ trợ dry_run: true).
  • Trạng thái consent opted_out chặn tin nhắn marketing và loại khách hàng khỏi POST /v1/campaigns/{id}/dry-runs & /sends.
  • POST /v1/inventory-reservations và POST /v1/orders khóa dòng (row-lock) chống bán quá tồn kho (409 INSUFFICIENT_STOCK).
  • Để chuyển lượt giữ hàng thành đơn, truyền reservation_id còn hiệu lực của cùng tích hợp và đúng sản phẩm, biến thể, số lượng. Lệnh commit riêng trừ tồn kho ngay.
  • PATCH /v1/orders/{id} chỉ cho phép sửa metadata/ghi chú/địa chỉ; chuyển trạng thái qua command /confirmations, /cancellations, /fulfillments. Hủy đơn hoàn tồn kho idempotent.
  • Ghi nhận thanh toán thủ công qua POST /v1/orders/{id}/manual-payment-records với scope payments:record và currency của đơn. Tạo yêu cầu hoàn tiền qua POST /v1/orders/{id}/refunds với scope payments:refund. Sau khi tiền đã được hoàn ở hệ thống thanh toán, ghi mã đối chiếu qua POST /v1/refunds/{id}/confirmations.
  • POST /v1/bookings kiểm tra sức chứa theo timezone UTC chuẩn xác và vô hiệu hóa reminder cũ khi reschedule/hủy lịch.
  • POST /v1/data-erasure-requests kiểm tra legal hold trước khi xóa PII và ghi nhận SHA-256 hashes (không lưu PII thô) vào deletion_ledger.
  • Sau khi khôi phục backup database, vận hành viên chạy php artisan public-api:replay-deletions để tự động xóa lại dữ liệu đã từng yêu cầu xóa.

Backend cấp tp_cs_* qua POST /v1/client-sessions. Phiên khách ẩn danh mới bắt đầu với lịch sử riêng. Để nối lại lịch sử của khách đã xác thực, backend dùng bearer workspace làm khóa HMAC-SHA256 và ký chuỗi SHA-256 dạng hex của JSON có các khóa channel, customer, integration, visitor, workspace theo thứ tự chữ cái. Dùng public ID từ API và giữ giá trị null cho channel hoặc customer còn trống. Gửi chữ ký hex trong identity_proof và khai báo allowed_origin cho widget trình duyệt.