Store Platforms

Tích hợp Squarespace API: API key, OAuth, webhook và giới hạn tốc độ

Tìm hiểu tích hợp Squarespace API: API key và OAuth, làm mới token, giới hạn 300 request/phút, webhook đơn hàng và Products API v2.

Ảnh đại diện Long Nguyen

Long Nguyen

Lập trình viên Fullstack · Kỹ sư AI · Nhà nghiên cứu

• • 4 phút đọc •

Tích hợp Squarespace API thực sự làm được gì?

Tích hợp Squarespace API kết nối phần mềm của bạn với website của người bán thông qua Squarespace Commerce APIs: các endpoint REST được cung cấp qua HTTPS từ api.squarespace.com, chỉ sử dụng JSON và xác thực bằng API key hoặc access token OAuth 2.0. Các API này bao phủ phần thương mại của website (sản phẩm, đơn hàng, tồn kho, danh bạ, mã giảm giá, giao dịch), đồng thời có thể gửi sự kiện đơn hàng và liên hệ đến máy chủ của bạn qua webhook.

Cách hình dung hữu ích là mỗi đối tượng nghiệp vụ có một API riêng, với cấp quyền riêng:

API Chức năng Điểm cần lưu ý
Orders Đọc đơn hàng mua một lần và đơn đăng ký, nhập đơn từ các kênh bán hàng khác, đánh dấu đơn đã hoàn tất xử lý và kích hoạt thông báo giao hàng Không bao gồm khoản quyên góp; hãy dùng Transactions
Products Tạo, cập nhật và xóa sản phẩm, biến thể cùng hình ảnh v2 là phiên bản hiện tại; v1.0 và v1.1 là phiên bản cũ
Inventory Đọc và điều chỉnh tồn kho của các biến thể sản phẩm Có quyền riêng, tách biệt với Products
Contacts Quản lý khách hàng, người đăng ký và người quyên góp, sổ địa chỉ cùng tùy chọn tiếp thị Thay thế Profiles API cho các dự án mới
Discounts Quản lý mã giảm giá, điều kiện áp dụng và giá trị giảm Quyền đọc và ghi là hai scope riêng
Transactions Quản lý giao dịch tài chính của đơn hàng và khoản quyên góp Chỉ đọc
Webhook Subscriptions Đăng ký endpoint để nhận sự kiện từ website Chỉ hỗ trợ OAuth; API key sẽ bị từ chối

Có hai chi tiết giúp tránh phải làm lại. Profiles API đang ở chế độ bảo trì, vì vậy mọi dự án mới nên dùng Contacts. Ngoài ra, vì Orders API không bao gồm khoản quyên góp, một tích hợp báo cáo hoặc kế toán cần ghi nhận mọi khoản thanh toán cũng phải dùng Transactions API.

Squarespace API key hay OAuth: hãy quyết định trước khi viết code

Đây là quyết định quan trọng nhất vì nó ảnh hưởng đến khả năng sử dụng webhook, giới hạn tốc độ áp dụng và cách bạn lưu thông tin xác thực.

  API key OAuth 2.0
Dành cho Ứng dụng tùy chỉnh trên một website của người bán Ứng dụng thương mại và Extension được nhiều website sử dụng
Điều kiện Website phải dùng gói Commerce Advanced Ứng dụng phải được đăng ký với Squarespace dưới dạng OAuth client
Cách cấp quyền Tạo key trong phần cài đặt của website Chủ website phê duyệt ứng dụng trên trang xác nhận của Squarespace
Thời hạn Không hết hạn khi website còn hoạt động Access token 30 phút, refresh token 7 ngày
Quyền Read Only hoặc Read and Write cho từng API, chọn khi tạo key Các scope như website.orders, yêu cầu trong từng lần cấp quyền
Webhooks Không hỗ trợ Có hỗ trợ
Giới hạn Create Order 100 request mỗi giờ cho mỗi website Không áp dụng giới hạn này

Quy tắc đơn giản là: nếu tích hợp phục vụ nhiều hơn một người bán, bạn phải dùng OAuth. Nếu chỉ phục vụ một cửa hàng mà bạn sở hữu hoặc quản lý, API key là con đường ngắn nhất, nhưng bạn sẽ mất webhook và phải polling để phát hiện thay đổi. Đánh đổi này thường phù hợp với việc đồng bộ đơn hàng và tồn kho ở cửa hàng nhỏ, nhưng không phù hợp nếu doanh nghiệp cần phản ứng gần như tức thời khi có đơn mới.

Tài liệu xác thực và quyền truy cập chính thức liệt kê cấp quyền cho từng API và xác nhận rằng mỗi request chỉ có thể xem dữ liệu của website sở hữu key hoặc token đó.

Cách lấy Squarespace API key và gửi request đầu tiên

  1. Đăng nhập vào website Squarespace (website phải dùng gói Commerce Advanced).
  2. Vào Settings, chọn Advanced, tiếp tục chọn Developer API Keys rồi nhấp Generate Key.
  3. Đặt tên cho key và chọn các API cùng cấp quyền cần thiết. Chỉ cấp quyền tối thiểu: một hệ thống đồng bộ giao hàng thường chỉ cần Orders (Read and Write).
  4. Sao chép key ngay lập tức vì key chỉ được hiển thị một lần.

Mỗi request cần có header Authorization: Bearer và header User-Agent mô tả ứng dụng của bạn. Request không có User-Agent sẽ bị từ chối; các giá trị mặc định như curl/7.54.0 có thể khiến giới hạn tốc độ bị áp dụng nghiêm ngặt hơn, vì vậy hãy tự đặt giá trị riêng. HTTP không mã hóa cũng bị từ chối.

curl 'https://api.squarespace.com/1.0/commerce/orders?paymentStates=PAID,PARTIALLY_PAID' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'User-Agent: acme-orders-sync/1.0'

Hãy lưu key trong trình quản lý secrets, không đưa vào source control. Vì key không tự hết hạn, một key bị lộ vẫn hợp lệ cho đến khi có người xóa nó trong dashboard.

OAuth flow và việc làm mới token của Squarespace hoạt động thế nào?

Squarespace sử dụng authorization-code flow tiêu chuẩn. Bạn đăng ký client, đưa chủ website đến authorization URL, nhận mã dùng một lần tại redirect URI rồi đổi mã đó lấy token. Khi đăng ký, bạn cần cung cấp tên client, biểu tượng, redirect URI cùng liên kết đến điều khoản và chính sách quyền riêng tư; sau đó Squarespace cấp client ID và secret.

Trung tâm trợ giúp của Squarespace cho biết biểu mẫu cũ dành cho các ứng dụng OAuth mới sẽ ngừng được sử dụng vào ngày để chuyển sang quy trình tự phục vụ. Tài liệu dành cho nhà phát triển vẫn liên kết đến trang developer-apps, vì vậy hãy kiểm tra quy trình đăng ký hiện tại trước khi lập kế hoạch thời gian.

https://login.squarespace.com/api/1/login/oauth/provider/authorize
  ?client_id=YOUR_CLIENT_ID
  &redirect_uri=https://app.example.com/oauth/callback
  &scope=website.orders.read,website.inventory
  &state=RANDOM_CSRF_VALUE
  &access_type=offline
Scope Quyền được cấp
website.orders / website.orders.read Gửi dữ liệu đơn hàng và đánh dấu đơn đã hoàn tất / xem đơn hàng và trạng thái hoàn tất
website.products / website.products.read Xem và chỉnh sửa sản phẩm / xem sản phẩm
website.inventory / website.inventory.read Xem và cập nhật tồn kho / xem tồn kho
website.contacts / website.contacts.read Quản lý liên hệ và sổ địa chỉ / xem các dữ liệu này
website.discounts / website.discounts.read Xem và quản lý mã giảm giá / xem mã giảm giá
website.transactions.read Dữ liệu giao dịch đơn hàng và khoản quyên góp

Bốn chi tiết trong hướng dẫn OAuth là nguyên nhân của phần lớn lỗi khi thử lần đầu:

  • Authorization code có hiệu lực trong hai phút và chỉ dùng được một lần. Mã này được gửi dưới dạng URL-encoded, vì vậy hãy decode trước khi gửi đến token endpoint.
  • Token endpoint yêu cầu header Basic được tạo từ client_id:client_secret, cùng với User-Agent. Thiếu User-Agent sẽ tạo ra lỗi tham chiếu đến SEC-43.
  • Access token có hiệu lực 30 phút. Nếu không có access_type=offline, bạn sẽ không nhận được refresh token và người dùng phải cấp quyền lại.
  • Refresh token có hiệu lực 7 ngày và chỉ dùng một lần: mỗi lần refresh trả về refresh token mới, còn token cũ bị vô hiệu hóa khi access token mới được sử dụng.

Quy tắc cuối cùng thường khiến tích hợp production bị lỗi. Nếu hai worker cùng refresh một lúc, một worker sẽ gửi refresh token đã bị sử dụng, khiến chuỗi token bị hỏng và buộc người bán phải cấp quyền lại. Hãy thực hiện refresh tuần tự sau một lock và lưu cặp token mới vào bộ nhớ bền vững trước khi sử dụng. Vì mỗi lần refresh cấp một token mới có thời hạn bảy ngày, worker chạy liên tục sẽ duy trì kết nối; nhưng nếu ngừng hoạt động quá một tuần, worker sẽ mất quyền truy cập.

import base64
import threading
import time
import requests

TOKEN_URL = 'https://login.squarespace.com/api/1/login/oauth/provider/tokens'
USER_AGENT = 'acme-orders-sync/1.0'
_lock = threading.Lock()  # use a database row lock if you run several processes


def _basic(client_id, client_secret):
    raw = f'{client_id}:{client_secret}'.encode()
    return 'Basic ' + base64.b64encode(raw).decode()


def get_access_token(store, client_id, client_secret):
    # store: dict with access_token, access_token_expires_at, refresh_token
    with _lock:
        if store['access_token_expires_at'] - time.time() > 10:
            return store['access_token']
        resp = requests.post(
            TOKEN_URL,
            headers={
                'Authorization': _basic(client_id, client_secret),
                'Content-Type': 'application/json',
                'User-Agent': USER_AGENT,
            },
            json={'grant_type': 'refresh_token', 'refresh_token': store['refresh_token']},
            timeout=30,
        )
        resp.raise_for_status()
        data = resp.json()
        store['access_token'] = data['access_token']
        store['access_token_expires_at'] = float(data['access_token_expires_at'])
        store['refresh_token'] = data['refresh_token']  # persist before using the token
        return store['access_token']

Khi bất kỳ request nào trả về 401, token đã hết hạn hoặc người bán đã thu hồi quyền truy cập. Đừng tiếp tục retry; hãy hiển thị cho người dùng lời nhắc kết nối lại.

Tự xây dựng hay bàn giao việc tích hợp Squarespace?

Bản thân các endpoint không quá khó. Phần tốn công nằm ở những việc xung quanh: đăng ký và xét duyệt OAuth client, lưu token an toàn khi có nhiều tiến trình đồng thời, chạy job đối soát các sự kiện bị bỏ lỡ và kiểm thử với dữ liệu cửa hàng thực tế như gói thanh toán, đơn đăng ký và danh mục có nhiều biến thể. Nếu tích hợp chỉ là tính năng phụ trong sản phẩm và bạn có một kỹ sư còn vài tuần rảnh, hãy tự xây dựng. Nếu nó kết nối Squarespace với marketplace, ERP hoặc hệ thống hoàn tất đơn hàng mà doanh nghiệp phụ thuộc vào, thường sẽ tiết kiệm hơn nếu nhờ đội ngũ chuyên về tích hợp API nền tảng cửa hàng lập phạm vi trước.

Giới hạn tốc độ Squarespace API và cách không vượt quá giới hạn

Giới hạn Giá trị Áp dụng cho
Giới hạn tốc độ chung 300 request mỗi phút (khoảng 5 request mỗi giây) Commerce APIs
Phản hồi khi vượt giới hạn 429 Too Many Requests, kèm thời gian chờ một phút Commerce APIs
Create Order 100 request mỗi giờ cho mỗi website Chỉ xác thực bằng API key; không áp dụng cho OAuth

Các giới hạn này khá thoải mái cho việc đồng bộ nhưng chặt hơn khi xử lý hàng loạt. Polling đơn hàng mỗi phút chỉ dùng chưa đến 1% ngân sách; trong khi một lần di chuyển danh mục tạo sản phẩm và tải hình ảnh từng request có thể chạm giới hạn chỉ sau vài giây. Giới hạn Create Order quan trọng hơn tưởng tượng: nhập đơn lịch sử từ kênh khác bằng API key chỉ đạt tối đa 100 đơn mỗi giờ trên mỗi website, nghĩa là một backlog lớn có thể mất nhiều ngày. Nếu cần nhập hàng loạt, đây là lý do nên cân nhắc OAuth.

Vì phản hồi 429 yêu cầu chờ đủ một phút, hãy lùi thời gian retry trong một phút thay vì retry ngay, nếu không bạn chỉ kéo dài thời gian chờ.

import time
import requests

USER_AGENT = 'acme-orders-sync/1.0'


def sqsp_get(path, token, params=None):
    url = f'https://api.squarespace.com{path}'
    headers = {'Authorization': f'Bearer {token}', 'User-Agent': USER_AGENT}
    for _ in range(3):
        r = requests.get(url, headers=headers, params=params, timeout=30)
        if r.status_code == 429:
            time.sleep(60)  # documented cool-down is one minute
            continue
        r.raise_for_status()
        return r.json()
    raise RuntimeError('still rate limited after 3 attempts')

Squarespace cũng có tài liệu về header Idempotency-Key. Hãy đọc hướng dẫn đó trước khi thêm retry cho bất kỳ request nào tạo dữ liệu, để việc timeout rồi retry không tạo bản ghi trùng lặp.

Squarespace webhook: sự kiện nào được kích hoạt và sự kiện nào không?

Webhook được quản lý thông qua Webhook Subscriptions API, yêu cầu OAuth access token. API key không thể tạo, liệt kê hoặc xóa subscription. Bạn đăng ký một endpoint HTTPS và danh sách topic; các topic được tài liệu ghi nhận tập trung vào order.create, order.update, extension.uninstall cùng các sự kiện tạo, cập nhật và xóa liên hệ hoặc địa chỉ. Token phải có scope tương ứng: website.orders hoặc website.orders.read cho topic đơn hàng, website.contacts cho topic liên hệ và địa chỉ, còn extension.uninstall không cần scope.

import requests

resp = requests.post(
    'https://api.squarespace.com/1.0/webhook_subscriptions',
    headers={
        'Authorization': f'Bearer {access_token}',
        'User-Agent': 'acme-orders-sync/1.0',
        'Content-Type': 'application/json',
    },
    json={
        'endpointUrl': 'https://sync.example.com/hooks/squarespace',
        'topics': ['order.create', 'order.update', 'extension.uninstall'],
    },
    timeout=30,
)
resp.raise_for_status()
secret = resp.json()['secret']  # returned only on create and on secret rotation

Phản hồi bao gồm một secret dạng giá trị hexadecimal dùng để xác minh thông báo thực sự đến từ Squarespace. Secret chỉ hiển thị khi bạn tạo subscription hoặc xoay vòng secret, vì vậy hãy lưu ngay lập tức. Làm theo hướng dẫn xác minh thông báo trong tài liệu webhook để kiểm tra chữ ký chính xác và từ chối mọi request không vượt qua kiểm tra. Sau khi xoay vòng secret, secret cũ sẽ không còn hoạt động.

Dùng thao tác send-test-notification để kiểm tra endpoint. Đây là request dùng một lần và sẽ không được gửi lại nếu thất bại hoặc timeout. Với các lần gửi thực tế, hãy kiểm tra tài liệu webhook để biết chính xác cơ chế xác nhận và retry; dù thế nào cũng nên làm handler có tính idempotent: phản hồi xác nhận nhanh, đưa order ID vào queue rồi xử lý bất đồng bộ.

Hãy đăng ký extension.uninstall ngay cả khi bạn chỉ quan tâm đến đơn hàng. Đây là cách bạn biết người bán đã ngắt kết nối, từ đó dừng đồng bộ và xóa token của họ.

Cách đồng bộ đơn hàng Squarespace mà không bỏ sót dữ liệu

Hãy xem webhook như chuông báo cửa, còn endpoint liệt kê đơn hàng mới là nguồn dữ liệu chuẩn. Lý do nằm trong chính các quy tắc của Orders API:

  • Mặc định, danh sách đơn hàng chỉ trả về các trạng thái thanh toán NOT_CHARGED, AUTHORIZED, PAID và REFUNDED. Các đơn ở trạng thái PENDING, FAILED, PARTIALLY_PAID, REFUND_PENDING hoặc REFUND_FAILED bị loại trừ, trừ khi bạn truyền chúng trong tham số paymentStates.
  • Gói thanh toán (đặt cọc khi checkout rồi trả các kỳ theo lịch) là một đơn hàng duy nhất, trong đó paymentState thay đổi khi các kỳ thanh toán đến hạn. Với những đơn này, order.create chỉ được kích hoạt khi trạng thái chuyển sang PAID, tức sau khi thu đủ mọi kỳ thanh toán. Không có webhook nào cho khoản đặt cọc hoặc các kỳ thanh toán trung gian.
  • order.update bao gồm việc hoàn tất đơn, hoàn tiền, hủy đơn, đánh dấu đang chờ xử lý và thay đổi email.

Vì vậy, một tích hợp chỉ dùng webhook sẽ âm thầm bỏ sót các đơn hàng mới thuộc gói thanh toán trong nhiều tuần. Mô hình bền vững là xử lý sự kiện order.create và order.update bằng cách lấy đơn hàng theo ID rồi upsert; đồng thời chạy job theo lịch để liệt kê các đơn có paymentStates bao gồm PARTIALLY_PAID và đối soát những đơn còn thiếu trong cơ sở dữ liệu. Dùng Squarespace order ID làm khóa bản ghi để việc gửi lại sự kiện không gây lỗi.

Ở chiều ngược lại, Orders API có thể đánh dấu đơn đã hoàn tất và kích hoạt thông báo giao hàng, phù hợp để tích hợp với hệ thống vận chuyển hoặc 3PL. API cũng có thể nhập đơn từ các kênh bên thứ ba, nhưng phải tuân theo giới hạn Create Order nói trên.

Đồng bộ sản phẩm và tồn kho với Products API v2

Hãy dùng v2 cho các dự án mới. Phiên bản này hỗ trợ bốn loại sản phẩm: sản phẩm vật lý, dịch vụ, thẻ quà tặng và sản phẩm tải xuống. Các phiên bản cũ v1.0 và v1.1 vẫn được hỗ trợ nhưng có phạm vi hẹp hơn. Sản phẩm vật lý hoạt động trên mọi phiên bản; sản phẩm dịch vụ và thẻ quà tặng chỉ có ở v2; còn sản phẩm tải xuống bị hạn chế nhiều nhất: trong v2, chúng có thể được đọc và cập nhật nhưng không thể tạo hoặc xóa, đồng thời không thể có biến thể.

Những yếu tố ảnh hưởng đến việc đồng bộ danh mục:

  • Mỗi sản phẩm thuộc chính xác một trang cửa hàng và chỉ có thể mua khi cả trang cửa hàng được bật lẫn sản phẩm được đặt ở trạng thái hiển thị. Một sản phẩm nhập thành công nhưng không bán được thường là do một trong hai cài đặt này.
  • Mỗi sản phẩm có thể có tối đa 100 hình ảnh. Việc tải hình ảnh diễn ra bất đồng bộ và có endpoint riêng để kiểm tra trạng thái xử lý, vì vậy hãy polling endpoint này trước khi cho rằng hình ảnh đã hoạt động hoặc gán nó cho một biến thể.
  • Các danh mục mà trang cửa hàng sử dụng để nhóm sản phẩm không khả dụng thông qua API. Hãy dự trù một bước thủ công hoặc cách tiếp cận khác cho cấu trúc danh mục.
  • Tồn kho nằm ở cấp biến thể và được xử lý bằng Inventory API với quyền hoặc scope riêng, vì vậy một hệ thống đồng bộ thay đổi cả giá lẫn tồn kho cần có cả hai quyền.

Hãy quyết định hệ thống nào sở hữu từng trường dữ liệu trước khi viết job đồng bộ đầu tiên. Một cách phân chia phổ biến là hệ thống merchandising quản lý tiêu đề, mô tả và hình ảnh, còn hệ thống tồn kho quản lý số lượng. Các topic webhook được Squarespace công bố tập trung vào đơn hàng và liên hệ, vì vậy hãy kiểm tra danh sách hiện tại trước khi thiết kế đồng bộ tồn kho theo hướng push; polling Inventory API theo lịch là lựa chọn mặc định an toàn.

Squarespace API không thể làm gì?

  • API key không hỗ trợ webhook. Webhook subscription yêu cầu OAuth.
  • Orders không có dữ liệu quyên góp. Hãy dùng Transactions API.
  • Không có danh mục của trang cửa hàng. Products API không cung cấp dữ liệu này.
  • Không nên xây dựng dự án mới trên Profiles. API này đang ở chế độ bảo trì; hãy dùng Contacts.
  • Không có quyền truy cập mở vào dữ liệu gửi qua biểu mẫu. Forms API key được tài liệu mô tả chỉ dành cho tích hợp Zapier.
  • Không hỗ trợ truy cập liên website. Một key hoặc token chỉ xem được website sở hữu nó, vì vậy tích hợp nhiều cửa hàng cần một bộ thông tin xác thực cho từng cửa hàng.

Checklist trước khi đưa tích hợp Squarespace vào vận hành

  1. Đã chủ động chọn API key hoặc OAuth và hiểu rõ hệ quả đối với webhook cùng Create Order.
  2. Đã yêu cầu bộ quyền nhỏ nhất nhưng vẫn đáp ứng công việc.
  3. Đã đặt User-Agent mô tả rõ ràng cho mọi request, bao gồm cả request lấy token.
  4. Đã tuần tự hóa việc sử dụng refresh token và lưu cặp token mới trước khi dùng.
  5. Đã chờ đủ một phút khi gặp 429.
  6. Đã xác minh chữ ký webhook, lưu secret và làm handler có tính idempotent.
  7. Đã thêm job đối soát bao gồm các đơn PARTIALLY_PAID.
  8. Đã xử lý 401 và extension.uninstall bằng cách ngắt kết nối người bán một cách an toàn.

Nếu bạn muốn một kế hoạch triển khai cụ thể thay vì checklist, hãy cho chúng tôi biết Squarespace cần kết nối với những hệ thống nào. Chúng tôi sẽ đề xuất phương án và gửi báo giá thông qua biểu mẫu nhận báo giá miễn phí.

CÂU HỎI THƯỜNG GẶP

Câu hỏi thường gặp

Squarespace có public API không?

Có. Squarespace cung cấp Commerce APIs cho đơn hàng, sản phẩm, tồn kho, liên hệ, mã giảm giá, giao dịch và webhook subscription. Đây là các REST API tại api.squarespace.com, trả về JSON và xác thực bằng API key hoặc OAuth 2.0 access token.

Tôi có cần gói Squarespace trả phí để sử dụng API không?

Với ứng dụng tùy chỉnh sử dụng API key, website cần gói Commerce Advanced. OAuth thì khác: các ứng dụng được xây dựng dưới dạng Squarespace Extension có thể được khách hàng sử dụng ở mọi gói, nhưng nhà phát triển phải đăng ký ứng dụng với Squarespace dưới dạng OAuth client.

Giới hạn tốc độ của Squarespace API là bao nhiêu?

Commerce APIs cho phép 300 request mỗi phút, tương đương khoảng 5 request mỗi giây. Vượt quá giới hạn sẽ trả về phản hồi 429 và yêu cầu chờ một phút. Endpoint Create Order có giới hạn riêng là 100 request mỗi giờ cho mỗi website khi xác thực bằng API key; giới hạn này không áp dụng cho OAuth.

Tôi có thể dùng Squarespace webhook với API key không?

Không. Webhook Subscriptions API yêu cầu OAuth access token và không hỗ trợ API key. Nếu dùng API key, bạn cần polling Orders API theo lịch để phát hiện thay đổi.

Token OAuth của Squarespace có hiệu lực trong bao lâu?

Access token có hiệu lực 30 phút. Nếu yêu cầu access_type=offline, bạn sẽ nhận thêm refresh token có hiệu lực 7 ngày. Refresh token chỉ dùng được một lần: mỗi lần refresh trả về refresh token mới và vô hiệu hóa token cũ, vì vậy hãy lưu cặp token mới nhất và tránh để nhiều worker refresh cùng lúc.

Tại sao webhook đơn hàng Squarespace không được kích hoạt khi có đơn mới?

Với đơn hàng theo gói thanh toán, webhook order.create chỉ được kích hoạt khi đơn chuyển sang trạng thái PAID hoàn toàn, không phải khi khoản đặt cọc được thu. Để thấy các đơn này ngay khi chúng được tạo, hãy liệt kê đơn hàng với tham số paymentStates bao gồm PARTIALLY_PAID.

Nên dùng Profiles API hay Contacts API?

Hãy dùng Contacts API cho các tích hợp mới. Squarespace đã đưa Profiles API vào chế độ bảo trì và hướng các dự án mới sang Contacts. API này quản lý khách hàng, người đăng ký và người quyên góp, cùng với sổ địa chỉ và tùy chọn tiếp thị.

Cập nhật cùng Netalith

Nhận kiến thức công nghệ, cập nhật sản phẩm và ưu đãi đặc biệt qua email.