Xác minh qua điện thoại

Xác minh qua điện thoại bao gồm 2 phương thức Tài khoản mà bạn có thể dùng để thêm và xác minh số điện thoại cho tài khoản người bán. Số điện thoại bạn gửi qua quy trình xác minh bằng điện thoại sẽ thay thế số điện thoại bạn có thể đã gửi qua accounts.AccountBusinessInformation.

Bạn nên xác minh số điện thoại cho tất cả người bán mới và hiện tại. Nếu không, tài khoản của bạn có thể bị tạm ngưng do vấn đề về trạng thái tài khoản PENDING_PHONE_VERIFICATION cho đến khi bạn xác minh một số điện thoại.

Bạn phải thực hiện 2 bước để xác minh số điện thoại:

  1. Gọi đến số accounts.requestphoneverification để bắt đầu yêu cầu xác minh qua điện thoại.
    Nhập mã vùng gồm 2 chữ cái.
    Nhập số điện thoại của bạn.
    Chọn một phương thức xác minh (SMS hoặc PHONE_CALL).
  2. Gọi đến số accounts.verifyphonenumber để xác minh số điện thoại.
    Nhập verificationId từ Bước 1.
    Nhập mã gồm 6 chữ số verificationCode được gửi đến điện thoại của bạn.
    Nhập phoneVerificationMethod đã dùng.
    Lệnh gọi này trả về một verifiedPhoneNumber. Số điện thoại này hiện đã được xác minh.

Bạn có thể kiểm tra trạng thái xác minh số điện thoại của tài khoản trong phần AccountBusinessInformation.phoneVerificationStatus.

accounts.requestphoneverification

Bắt đầu quy trình xác minh số điện thoại bằng cách truyền phoneRegionCode, phoneNumber và phoneVerificationMethod vào accounts.requestphoneverification. Lệnh gọi này trả về một verificationId.

Bạn có thể sử dụng trường languageCode (không bắt buộc) để xác minh bằng một ngôn ngữ khác ngoài ngôn ngữ mặc định (tiếng Anh của Hoa Kỳ).

Bạn có thể thử xác minh cùng một số điện thoại tối đa 5 lần trong mỗi 4 giờ.

POST https://www.googleapis.com/content/v2.1/merchantId/accounts/accountId/requestphoneverification

Sau đây là một lệnh gọi mẫu:

{
  "phoneRegionCode": "US",
  "phoneNumber": "phoneNumber",
  "phoneVerificationMethod": "SMS",
  "languageCode": "en-US"
}

Sau đây là một phản hồi mẫu:

{
  "verificationId": "2-47b7ef80ff494daf8079f4808e750dcb-1626331725036"
}

accounts.verifyphonenumber

Xác minh số điện thoại của tài khoản bằng cách truyền verificationId từ accounts.requestphoneverification, verificationCode gồm 6 chữ số được gửi đến điện thoại của bạn và phoneVerificationMethod mà bạn đã dùng, ví dụ: SMS, vào accounts.verifyphonenumber. Lệnh gọi này trả về số điện thoại đã xác minh theo định dạng tiêu chuẩn cho khu vực của bạn.

Yêu cầu xác minh ban đầu của bạn sẽ hết hạn sau 15 phút. Sau đó, bạn phải bắt đầu một yêu cầu xác minh qua điện thoại mới trước khi gọi accounts.verifyphonenumber.

POST https://www.googleapis.com/content/v2.1/merchantId/accounts/accountId/verifyphonenumber

Sau đây là một lệnh gọi mẫu:

{
  "verificationId": "verificationId",
  "verificationCode": "verificationCode",
  "phoneVerificationMethod": "SMS"
}

Sau đây là một phản hồi mẫu:

{
  "verifiedPhoneNumber": "(123) 456-7890"
}

AccountBusinessInformation.phoneVerificationStatus

Bạn có thể kiểm tra trạng thái xác minh số điện thoại của tài khoản trong trường AccountBusinessInformation.phoneVerificationStatus.

Gọi phương thức accounts.get bằng accountId và merchantId để xem thông tin doanh nghiệp của tài khoản:

GET https://www.googleapis.com/content/v2.1/v2.1/merchantId/accounts/accountId