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 nhanh chóng mua sắm 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ể giúp 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 cách sử dụ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ý sử dụng 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 của bạn.

Đ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 quan, hãy nhớ làm như sau:

  • Bạn phải được phê duyệt và tham gia chương trình Quảng cáo Mua sắm, trang thông tin miễn phí hoặc cả hai.
  • Quốc gia bán 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 quy trình thanh toán, bạn có thể sử dụng các phương thức sau:

Tạo chế độ cài đặt quy trình 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 phần nội dung yêu cầu.

Sau đây là một 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 giá trị nhận dạng duy nhất của tài khoản Merchant Center.

Dưới đâ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 quy trình thanh toán

Để truy xuất chế độ cài đặt quy trình thanh toán, bao gồm mẫu URL, đí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à một yêu cầu mẫu:

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

Dưới đâ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 quy trình 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 phần 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

Dưới đây là một yêu cầu mẫu để cập nhật URL và xoá đích đến của 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"
  ]
}

Dưới đâ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ý chương trình thanh toán và ngăn các đường liên kết thanh toán xuất hiện trên 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à một yêu cầu mẫu:

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

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

Bạn có hai 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 áp dụng cho tất cả sản phẩm đủ điều kiện của bạn. Bạn nên sử dụng một URL nhất quán cho các sản phẩm của mình. Chẳng hạn như yourstore.com/checkout?id={id}.

  • Cấp sản phẩm (Nguồn cấp dữ liệu): Để cung cấp 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ỉ cho phép bạn cung cấp trang 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 các 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 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 cho phép bạn thêm một URL thanh toán vào dữ liệu sản phẩm. URL này giúp người mua sắm trực tuyến có thể truy cập trực tiếp vào trang thanh toán từ trang thông tin của bạn. Tệp này phải chứa phần giữ chỗ tham số {ID} và có một miền khớp.

Khi bạn thiết lập các đường liên kết 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:

  • 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 đưa người dùng đến trang giỏ hàng của bạn với một 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 đảm bảo rằng bạn đáp ứng các yêu cầu sau:

  • Mẫu URL của bạn 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 trong mẫu trang thanh toán được cung cấp phải khớp với miền của sản phẩm.

Tìm hiểu thêm