Thiết lập thanh toán

Thông tin thanh toán là đường liên kết cấp tài khoản giữa tài khoản Google Ads và tài khoản Thanh toán (còn gọi là thông tin lập hoá đơn). Thông tin này giúp xác định hiệu quả người sẽ trả phí cho các chi phí phát sinh theo ngân sách tài khoản của thông tin thanh toán. Mỗi Tài khoản thanh toán tương ứng với một hoá đơn.

Giới thiệu về Tài khoản thanh toán

Mỗi BillingSetup xác định một Tài khoản thanh toán được lập hoá đơn cho các chi phí phát sinh theo ngân sách tài khoản. Tài khoản Thanh toán này được liên kết với một Hồ sơ thanh toán chịu trách nhiệm cuối cùng đối với các khoản phí.

Thông tin thanh toán chứa cả trường payments_account và một nhóm các trường payments_account_info giúp xác định Tài khoản thanh toán đang được sử dụng, bao gồm:

Nếu một Tài khoản thanh toán đủ điều kiện sử dụng tính năng thanh toán tổng hợp, thì bạn có thể nhóm nhiều tài khoản Google Ads trong cùng một hoá đơn bằng cách thiết lập thông tin thanh toán của các tài khoản đó để sử dụng cùng một Tài khoản thanh toán cơ bản.

Tạo thông tin thanh toán mới

Bạn có thể liên kết thông tin thanh toán mới với Tài khoản thanh toán hiện có hoặc tài khoản được tạo cùng lúc.

Sử dụng Tài khoản thanh toán hiện có

Để liên kết với một Tài khoản thanh toán hiện có, hãy đặt payments_account thành mã tài nguyên của một Tài khoản thanh toán hợp lệ. Tuy nhiên, đừng sửa đổi payments_account_info.

Bạn có thể liệt kê các tài khoản thanh toán có sẵn bằng phương thức PaymentsAccountService.ListPaymentsAccounts. PaymentsAccounts được trả về phụ thuộc vào tài khoản người quản lý mà bạn sử dụng để xác thực.

Đối với mỗi PaymentsAccount, mã nhận dạng của trình quản lý thanh toán nằm trong trường paying_manager_customer.

Sử dụng tài khoản thanh toán mới

Để liên kết với một Tài khoản thanh toán mới, hãy đặt các trường sau trong payments_account_info (không đặt payments_account):

Ví dụ dưới đây cho biết cách tạo thông tin thanh toán mới từ một mã hồ sơ thanh toán hiện có. Như đã chỉ ra ở trên, thao tác này cũng sẽ tạo một Tài khoản thanh toán mới có tên là My New Payments Account.

BillingSetup bsetup = BillingSetup.newBuilder()
    .setPaymentsAccountInfo(PaymentsAccountInfo.newBuilder()
        .setPaymentsAccountName("My New Payments Account")
        .setPaymentsProfileId("1234-5678-9012")
        .build())
    .setStartTimeType(TimeType.NOW)
    .build();

BillingSetupOperation op = BillingSetupOperation.newBuilder().setCreate(bsetup).build();

try (BillingSetupServiceClient billingSetupServiceClient = googleAdsClient
    .getBillingSetupServiceClient()) {

  MutateBillingSetupResponse response =
      billingSetupServiceClient.mutateBillingSetup(Long.toString(customerId), op);
}

Nếu đây là thông tin thanh toán đầu tiên được thêm vào tài khoản Google Ads, thì thông tin này sẽ giúp đăng ký thanh toán cho khách hàng một cách hiệu quả bằng cách sử dụng hồ sơ Thanh toán được tham chiếu.

Trạng thái thiết lập thông tin thanh toán

Các thực thể BillingSetup mới phải được phê duyệt trước khi có hiệu lực. Cho đến lúc đó, status của họ sẽ ở trạng thái PENDING.

BillingSetup có thể ở một trong các status sau:

Trạng thái thiết lập thông tin thanh toán Mô tả
PENDING Đang chờ phê duyệt.
APPROVED_HELD Đã được phê duyệt nhưng ngân sách đầu tiên tương ứng chưa được phê duyệt. Điều này chỉ có thể xảy ra đối với những thông tin thanh toán được định cấu hình để lập hoá đơn hằng tháng.
APPROVED Yêu cầu thiết lập đã được phê duyệt.
CANCELLED Người dùng đã huỷ thiết lập trước khi được phê duyệt.

Truy xuất thông tin thanh toán của tài khoản

Giống như hầu hết các thực thể khác trong API Google Ads, BillingSetup được tìm nạp bằng cách truy vấn GoogleAdsService.SearchStream bằng truy vấn Ngôn ngữ truy vấn Google Ads chỉ định các trường cần trả về.

Sau khi có tham chiếu đến BillingSetup, bạn có thể sử dụng tham chiếu đó để tạo AccountBudgetProposal như mô tả trong phần Ngân sách tài khoản.

Huỷ thông tin thanh toán đang chờ xử lý

Bạn có thể huỷ một BillingSetup chưa có hiệu lực bằng cách sử dụng thao tác xoá. Bạn chỉ có thể huỷ thông tin thanh toán nếu status của thông tin thanh toán đó là PENDING hoặc nếu thông tin thanh toán đó là APPROVED để bắt đầu vào một thời điểm nào đó trong tương lai.