Thông tin thanh toán là mối 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à thiết lập hoá đơn). Thông tin này giúp xác định một cách hiệu quả những người được lập hoá đơn cho các chi phí phát sinh từ 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 sẽ được lập hoá đơn cho chi phí phát sinh trong 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 về các khoản phí.
Thông tin thanh toán chứa cả trường payments_account
và nhóm trường payments_account_info
xác định tài khoản thanh toán đang được sử dụng, bao gồm các trường sau đây:
payments_account_info.payments_account_id
: Mã gồm 16 chữ số được dùng để xác định Tài khoản thanh toán được liên kết với thông tin thanh toán.payments_account_info.payments_account_name
: Tên của Tài khoản thanh toán được liên kết với thông tin thanh toán. Tên này được in trên hoá đơn hằng tháng.payments_account_info.payments_profile_id
: Mã gồm 12 chữ số dùng để xác định Hồ sơ thanh toán được liên kết với thông tin thanh toán.
Nếu một tài khoản thanh toán đủ điều kiện để 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 đặt thông tin thanh toá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 các tài khoản thanh toán hiện có hoặc những 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ã nhận dạng 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 hiện có 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 dùng để xác thực.
Đối với mỗi PaymentsAccount
, mã của trình quản lý thanh toán sẽ 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ụ bên dưới 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ư đã cho biết ở 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ì hệ thống sẽ giúp khách hàng đăng ký thanh toán 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 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
sẽ ở trạng thái PENDING
.
BillingSetup
có thể thuộc một trong các status
sau:
Trạng thái thiết lập thông tin thanh toán | Nội dung mô tả |
---|---|
PENDING |
Đang chờ phê duyệt. |
APPROVED_HELD |
Được chấp thuận nhưng ngân sách tương ứng đầu tiên chưa được chấp thuận. Điều này chỉ có thể xảy ra đối với những thông tin thanh toán được thiết lập để sử dụng phương thức lập hoá đơn hằng tháng. |
APPROVED |
Đã phê duyệt quy trình thiết lập. |
CANCELLED |
Người dùng đã hủy quá trình thiết lập trước khi 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
thông qua truy vấn Ngôn ngữ truy vấn Google Ads chỉ định các trường cần trả về.
Sau khi lấy thông tin tham chiếu đến BillingSetup
, bạn có thể sử dụng thông tin đó để 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ỷ BillingSetup
chưa có hiệu lực bằng thao tác xoá. Bạn chỉ có thể huỷ các chế độ thiết lập thanh toán nếu status
của thiết bị là PENDING
hoặc nếu status
là bắt đầu vào một thời điểm nào đó trong tương lai.APPROVED