Quy trình xác minh số điện thoại bao gồm hai bước
Phương thức tài khoản
mà bạn có thể sử 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 được gửi thông qua quy trình xác minh số điện thoại sẽ thay thế số điện thoại
các số điện thoại mà bạn có thể đã gửi qua
accounts.AccountBusinessInformation
.
Bạn nên xác minh qua điện thoại cho tất cả khách hàng mới và hiện tại
người bán. Nếu không, tài khoản của bạn có thể bị tạm ngưng với tài khoản này
trạng thái
PENDING_PHONE_VERIFICATION
cho đến khi bạn xác minh số điện thoại.
Bạn cần thực hiện hai bước bắt buộc để xác minh số điện thoại:
- Hãy gọi
accounts.requestphoneverification
để bắt đầu yêu cầu xác minh qua điện thoại. - Nhập khu vực gồm hai chữ cái của bạn .
- Nhập số điện thoại của bạn.
- Chọn một phương thức xác minh (
SMS
hoặcPHONE_CALL
).
- Hãy gọi
- Gọi
accounts.verifyphonenumber
để xác minh số điện thoại. - Nhập
verificationId
trong Bước 1. - Nhập 6 chữ số của
verificationCode
được gửi đến điện thoại của bạn. - Nhập
phoneVerificationMethod
được dùng. - Lệnh gọi này trả về một
verifiedPhoneNumber
. Số điện thoại này hiện là đã xác minh.
- Gọi
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
AccountBusinessInformation.phoneVerificationStatus
.
accounts.requestphoneverification
Bắt đầu quá trình xác minh số điện thoại bằng cách chuyể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 tuỳ chọn
languageCode
để xác minh bằng một ngôn ngữ không phải là ngôn ngữ mặc định (tiếng Anh (Mỹ).
Bạn có thể thử xác minh cùng một số điện thoại tối đa 5 lần mỗi 4 lần giờ.
POST https://www.googleapis.com/content/v2.1/merchantId/accounts/accountId/requestphoneverification
Dưới đây là một cuộc gọi mẫu:
{ "phoneRegionCode": "US", "phoneNumber": "phoneNumber", "phoneVerificationMethod": "SMS", "languageCode": "en-US" }
Dưới đây là phản hồi mẫu:
{ "verificationId": "2-47b7ef80ff494daf8079f4808e750dcb-1626331725036" }
accounts.verifyphonenumber
Xác minh số điện thoại cho tài khoản bằng cách chuyển verificationId
từ
accounts.requestphoneverification
, verificationCode
gồm sáu chữ số được gửi đến
và phoneVerificationMethod
mà bạn đã sử dụng (ví dụ: SMS
) vào
accounts.verifyphonenumber
.
Cuộc gọi này sẽ trả về số điện thoại đã xác minh trong một fomat 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 số đ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
Dưới đây là một cuộc gọi mẫu:
{ "verificationId": "verificationId", "verificationCode": "verificationCode", "phoneVerificationMethod": "SMS" }
Dưới đây là 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
AccountBusinessInformation.phoneVerificationStatus
.
Gọi
Phương thức accounts.get
với
accountId
và merchantId
để xem
thông tin doanh nghiệp:
GET https://www.googleapis.com/content/v2.1/v2.1/merchantId/accounts/accountId