Quản lý chế độ cài đặt quy trình thanh toán

Tính năng thanh toán giúp khách hàng đã sẵn sàng mua hàng mua sắm nhanh hơn bằng cách cho phép họ chuyển thẳng từ trang thông tin sản phẩm trên Google đến trang giỏ hàng hoặc trang thanh toán trên trang web của bạn. Điều này có thể cải thiện tỷ lệ chuyển đổi và mang đến trải nghiệm mua sắm suôn sẻ.

Với Merchant API, bạn có thể quản lý chế độ cài đặt cho tính năng này bằng tài nguyên CheckoutSettings.

Hướng dẫn này giải thích cách sử dụng Merchant API để tạo và quản lý việc đăng ký của bạn trong tính năng thanh toán theo phương thức lập trình.

Để biết thêm thông tin, hãy xem bài viết Thêm đường liên kết để thanh toán cho sản phẩm.

Điều kiện tiên quyết

Để sử dụng tài nguyên CheckoutSettings và các phương thức liên kết, hãy nhớ thực hiện những việc sau:

  • Bạn phải được phê duyệt và tham gia Quảng cáo mua sắm, trang thông tin miễn phí hoặc cả hai.
  • Quốc gia bán hàng của bạn phải là Hoa Kỳ.

Phương thức

Để tạo, truy xuất, cập nhật và xoá chế độ cài đặt thanh toán, bạn có thể sử dụng các phương thức sau:

Tạo chế độ cài đặt thanh toán

Để tạo chế độ cài đặt thanh toán, hãy sử dụng phương thức checkoutSettings.create. Thêm uri_settings với checkout_uri_template hoặc cart_uri_template và eligible_destinations đã chọn vào nội dung yêu cầu.

Sau đây là yêu cầu mẫu:

POST https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/checkout/checkoutSettings

{
  "uri_settings": {
    "checkout_uri_template": "https://www.your-store.com/checkout?item_id={id}"
  },
  "eligible_destinations": [
    "FREE_LISTINGS",
    "SHOPPING_ADS"
  ]
}

Thay thế {ACCOUNT_ID} bằng mã nhận dạng duy nhất của tài khoản Merchant Center của bạn.

Sau đây là phản hồi mẫu từ một lệnh gọi thành công:

{
  "name": "accounts/{ACCOUNT_ID}/programs/checkout/checkoutSettings",
  "uri_settings": {
    "checkout_uri_template": "https://www.your-store.com/checkout?item_id={id}"
  },
  "eligible_destinations": [
    "FREE_LISTINGS",
    "SHOPPING_ADS"
  ],
  "enrollment_state": "ENROLLED",
  "review_state": "IN_REVIEW",
  "effective_uri_settings": {
    "checkout_uri_template": "https://www.your-store.com/checkout?item_id={id}"
  },
  "effective_enrollment_state": "ENROLLED",
  "effective_review_state": "IN_REVIEW"
}

Truy xuất chế độ cài đặt thanh toán

Để truy xuất chế độ cài đặt thanh toán, bao gồm cả mẫu URL, các đích đến đã chọn, trạng thái đăng ký và trạng thái xem xét URL, hãy sử dụng phương thức checkoutSettings.get.

Sau đây là yêu cầu mẫu:

GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/checkout/checkoutSettings

Sau đây là phản hồi mẫu từ một lệnh gọi thành công:

{
  "name": "accounts/{ACCOUNT_ID}/programs/checkout/checkoutSettings",
  "uri_settings": {
    "checkout_uri_template": "https://www.your-store.com/checkout?item_id={id}"
  },
  "eligible_destinations": [
    "FREE_LISTINGS",
    "SHOPPING_ADS"
  ],
  "enrollment_state": "ENROLLED",
  "review_state": "APPROVED",
  "effective_uri_settings": {
    "checkout_uri_template": "https://www.your-store.com/checkout?item_id={id}"
  },
  "effective_enrollment_state": "ENROLLED",
  "effective_review_state": "APPROVED"
}

Cập nhật chế độ cài đặt thanh toán

Để cập nhật chế độ cài đặt thanh toán, hãy sử dụng phương thức checkoutSettings.update. Thêm các trường bạn muốn thay đổi vào nội dung yêu cầu và chỉ định các trường đó trong tham số truy vấn update_mask.

update_mask hỗ trợ các trường sau:

  • eligible_destinations
  • uri_settings

Sau đây là yêu cầu mẫu cập nhật URL và xoá đích đến quảng cáo:

PATCH https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/checkout/checkoutSettings?update_mask=uri_settings,eligible_destinations

{
  "uri_settings": {
    "cart_uri_template": "https://shop.your-store.com/add_to_cart?sku={id}"
  },
  "eligible_destinations": [
    "FREE_LISTINGS"
  ]
}

Sau đây là phản hồi mẫu từ một lệnh gọi thành công:

{
  "name": "accounts/{ACCOUNT_ID}/programs/checkout/checkoutSettings",
  "uri_settings": {
    "cart_uri_template": "https://shop.your-store.com/add_to_cart?sku={id}"
  },
  "eligible_destinations": [
    "FREE_LISTINGS"
  ],
  "enrollment_state": "ENROLLED",
  "review_state": "IN_REVIEW", // Review state will always be set to "IN_REVIEW" after URL update
  "effective_uri_settings": {
    "cart_uri_template": "https://shop.your-store.com/add_to_cart?sku={id}"
  },
  "effective_enrollment_state": "ENROLLED",
  "effective_review_state": "IN_REVIEW"
}

Xoá

Để xoá chế độ cài đặt thanh toán, hãy sử dụng phương thức checkoutSettings.delete.

Thao tác này sẽ xoá cấu hình ở cấp tài khoản, huỷ đăng ký bạn khỏi chương trình thanh toán và ngăn đường liên kết đến trang thanh toán xuất hiện trên các sản phẩm của bạn trong trang thông tin miễn phí và quảng cáo Mua sắm.

Sau đây là yêu cầu mẫu:

DELETE https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/checkout/checkoutSettings

Một lệnh gọi thành công sẽ trả về nội dung phản hồi trống.

Bạn có 2 cách để cung cấp URL thanh toán cho sản phẩm:

  • Cấp tài khoản (API phụ hoặc Merchant Center): Để xác định một mẫu URL duy nhất, checkout_uri_template hoặc cart_uri_template, bạn có thể sử dụng API phụ hoặc chế độ cài đặt Merchant Center. Mẫu này được áp dụng cho tất cả các sản phẩm đủ điều kiện. Bạn nên sử dụng một URL nhất quán cho tất cả sản phẩm. Ví dụ: yourstore.com/checkout?id={id}.

  • Cấp sản phẩm (Nguồn cấp dữ liệu): Để cung cấp một URL thanh toán cụ thể cho từng sản phẩm, hãy sử dụng thuộc tính checkout_link_template trong nguồn cấp dữ liệu sản phẩm. Điều này cho phép bạn tuỳ chỉnh URL cho từng sản phẩm hoặc chỉ cung cấp tính năng thanh toán cho một nhóm nhỏ trong kho hàng.

  • Nếu bạn đặt mẫu URL ở cấp tài khoản bằng API phụ này, hãy đảm bảo rằng bạn không gửi giá trị cho thuộc tính checkout_link_template trong nguồn cấp dữ liệu cho những sản phẩm đó.

  • Nếu bạn sử dụng thuộc tính nguồn cấp dữ liệu checkout_link_template, hãy đảm bảo rằng bạn không đặt mẫu URL ở cấp tài khoản bằng API phụ hoặc chế độ cài đặt Merchant Center. Bạn vẫn có thể sử dụng API phụ để chọn eligible_destinations mà không cần cung cấp uri_settings nếu bạn chỉ quản lý URL thông qua nguồn cấp dữ liệu.

Mẫu URL thanh toán

Mẫu URL thanh toán giúp bạn thêm một URL thanh toán trong dữ liệu sản phẩm. URL này giúp người mua sắm trực tuyến có thể chuyển thẳng đến trang thanh toán trong trang thông tin của bạn. Mẫu này phải chứa trình giữ chỗ tham số {ID} và có một miền phù hợp.

Khi thiết lập đường liên kết đến trang thanh toán bằng API phụ, hãy sử dụng trường uri_settings. Trường này chấp nhận một trong hai mẫu sau:

  • checkout_uri_template: Mẫu URL mà khi phần giữ chỗ được điền, sẽ chuyển hướng người dùng đến trang thanh toán của bạn với mặt hàng cụ thể đã sẵn sàng để mua.
  • cart_uri_template: Mẫu URL chuyển hướng người dùng đến trang giỏ hàng của bạn với mặt hàng cụ thể đã được thêm vào giỏ hàng.

Mẫu ví dụ

  • Thanh toán: https://www.your-store.com/checkout?item_id={id}
  • Giỏ hàng: https://shop.your-store.com/add_to_cart?product_sku={id}

Hãy nhớ đáp ứng các yêu cầu sau:

  • Mẫu URL phải trỏ đến một trang hợp lệ trên trang web của bạn, khớp với miền đã đăng ký, hoạt động bằng phương thức HTTP GET và không yêu cầu khách hàng đăng nhập.
  • Miền từ mẫu thanh toán được cung cấp phải khớp với miền sản phẩm.

Tìm hiểu thêm