DOCS

Hồ sơ khách hàng

Tải trước thông tin khách hàng lặp lại vào Zonos Checkout.

Hồ sơ khách hàng hợp lý hóa trải nghiệm thanh toán của bạn bằng cách cho phép khách hàng có tài khoản tải trước địa chỉ và chi tiết thanh toán của họ.

Tính năng này hiện chỉ có sẵn cho tích hợp API tùy chỉnh. Tính năng này chưa có sẵn cho những nhà bán hàng sử dụng các plugin Checkout.

Nếu bạn bán hàng cho nhà bán lại, cơ quan chính phủ hoặc tổ chức phi lợi nhuận, bạn cũng có thể đồng bộ hóa chứng nhận miễn thuế của họ vào một hồ sơ khách hàng.

Tạo hoặc cập nhật hồ sơ mà không cần khách hàng 

checkoutCustomerProfileAuthenticate yêu cầu khách hàng phải có mặt, vì nó cấp một mật khẩu dùng một lần cho phiên thanh toán đó. Khi bạn muốn tạo hoặc cập nhật một hồ sơ bên ngoài quy trình thanh toán—tải trước danh sách khách hàng của bạn, đồng bộ hóa các thay đổi hồ sơ từ hệ thống của riêng bạn, hoặc đính kèm chứng nhận miễn thuế trước đơn hàng đầu tiên của khách hàng—hãy sử dụng checkoutCustomerUpsert thay thế.

1mutation checkoutCustomerUpsert($input: CheckoutCustomerProfileInput!) {
2 checkoutCustomerUpsert(input: $input) {
3 customerId
4 email
5 name
6 phone
7 locations {
8 administrativeArea
9 countryCode
10 line1
11 line2
12 locality
13 postalCode
14 }
15 }
16}

Hồ sơ được khớp theo customerId, vì vậy việc gọi lặp lại sẽ cập nhật cùng một hồ sơ thay vì tạo bản sao. Có thể chạy an toàn trên toàn bộ danh sách khách hàng của bạn theo lịch trình.

Có ba điều cần biết về cách áp dụng các bản cập nhật:

  • Các trường bị bỏ qua sẽ được giữ nguyên. Chỉ gửi name sẽ cập nhật tên và giữ nguyên email và số điện thoại như trước.
  • Không thể xóa giá trị. Gửi một giá trị rỗng được xử lý giống như bỏ qua trường đó, vì vậy không có cách nào để xóa tên, email hoặc số điện thoại một khi đã được thiết lập.
  • Địa chỉ chỉ được thêm vào. Một địa chỉ đã tồn tại trong hồ sơ sẽ không bị trùng lặp, và các địa chỉ không có trong yêu cầu sẽ không bị xóa.

checkoutCustomerUpsert không trả về oneTimePassword. Để tải một hồ sơ vào Checkout, bạn vẫn cần checkoutCustomerProfileAuthenticate, vốn cấp một mật khẩu cho phiên đó.

GraphQL API ReferenceTypes, inputs, and operations used in this guide

Trang này có hữu ích không?