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 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. Nhờ đó, tỷ lệ chuyển đổi có thể tăng lên và trải nghiệm mua sắm cũng trở nên suôn sẻ hơn.

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ý tính năng thanh toán theo cách 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 quan, hãy nhớ làm 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 cùng 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à ví dụ về yêu cầ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à ví dụ về phản hồi 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, đí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à ví dụ về yêu cầu:

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

Sau đây là ví dụ về phản hồi 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à ví dụ về yêu cầ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à ví dụ về phản hồi 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ừng hiển thị đường liên kết đến trang thanh toá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à ví dụ về yêu cầ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 cá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 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 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ể truy cập trực tiếp vào trang thanh toán từ 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ó 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 trình 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ụ

  • Trang 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 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 sản phẩm.

Tìm hiểu thêm