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ờ đó, bạn 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 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ý của bạn trong tính năng thanh toán theo cách 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 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 phải là Hoa Kỳ.

Phương thức

Để tạo, truy xuất, cập nhật và xoá chế độ cài đặt khi 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 một chế độ cài đặt khi thanh toán, hãy sử dụng phương thức checkoutSettings.create. Thêm uri_settings có giá trị 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à 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 riêng biệt của tài khoản Merchant Center.

Sau đây là một 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 của quy trình thanh toán

Để truy xuất chế độ cài đặt thanh toán, bao gồm cả mẫu URL, các vị trí xuất hiện được 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

Sau đây là một 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 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"
  ]
}

Sau đây là một 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 quy trình 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 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ó thể cung cấp URL thanh toán cho sản phẩm theo 2 cách:

  • 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ả 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 tất cả sản phẩm. 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 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 quy trình thanh toán cho một nhóm nhỏ trong kho hàng.

  • Nếu bạn đặt một mẫu URL ở cấp tài khoản bằng cách sử dụ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 cách sử dụ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 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. URL này phải chứa phần giữ chỗ tham số {ID} và có một miền phù hợp.

Khi bạn thiết lập đường liên kết đến trang thanh toán bằng cách sử dụ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ột mẫu URL. Khi bạn điền sẵn giá trị giữ chỗ, mẫu này sẽ chuyển người dùng đến trang thanh toán của bạn, trong đó có mặt hàng cụ thể đã sẵn sàng để mua.
  • cart_uri_template: Một mẫu URL đưa người dùng đến trang giỏ hàng của bạn, trong đó có 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}

Đả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 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