การยืนยันทางโทรศัพท์

เลิกใช้งานแล้ว: ไม่จำเป็นต้องยืนยันหมายเลขโทรศัพท์อีกต่อไป และเราขอแนะนำว่าอย่าใช้ฟีเจอร์นี้ ฟีเจอร์นี้จะไม่พร้อมใช้งานใน Merchant API และเราขอแนะนำให้คุณวางแผนล่วงหน้าสำหรับการเปลี่ยนแปลงนี้

การยืนยันทางโทรศัพท์ประกอบด้วยเมธอด 2 รายการใน Accounts ที่คุณใช้เพื่อเพิ่มและยืนยันหมายเลขโทรศัพท์สำหรับบัญชี Merchant ได้ หมายเลขโทรศัพท์ที่ส่งผ่านการยืนยันทางโทรศัพท์จะแทนที่หมายเลขโทรศัพท์ที่คุณอาจส่งผ่าน accounts.AccountBusinessInformation

เราขอแนะนำอย่างยิ่งให้ผู้ขายใหม่และผู้ขายที่มีอยู่ทั้งหมดทำการยืนยันทางโทรศัพท์ มิฉะนั้น ระบบอาจระงับบัญชีของคุณเนื่องจากปัญหาเกี่ยวกับสถานะ บัญชี PENDING_PHONE_VERIFICATIONจนกว่าคุณจะยืนยันหมายเลขโทรศัพท์

การยืนยันหมายเลขโทรศัพท์ต้องทำตามขั้นตอนที่จำเป็น 2 ขั้นตอนดังนี้

1. เรียก accounts.requestphoneverification เพื่อเริ่มคำขอการยืนยันทางโทรศัพท์

   ป้อนรหัสภูมิภาค 2 ตัวอักษร

   ป้อนหมายเลขโทรศัพท์

   เลือกวิธีการยืนยัน (SMS หรือ PHONE_CALL)

2. เรียก accounts.verifyphonenumber เพื่อยืนยันหมายเลขโทรศัพท์

   ป้อน verificationId จากขั้นตอนที่ 1

   ป้อน verificationCode 6 หลักที่ส่งไปยังโทรศัพท์

   ป้อน phoneVerificationMethod ที่ใช้

   การเรียกนี้จะแสดงผล verifiedPhoneNumber หมายเลขโทรศัพท์นี้ได้รับการยืนยันแล้ว

คุณสามารถตรวจสอบสถานะการยืนยันทางโทรศัพท์ของบัญชีได้ใน AccountBusinessInformation.phoneVerificationStatus

accounts.requestphoneverification

เริ่มกระบวนการยืนยันหมายเลขโทรศัพท์โดยส่ง phoneRegionCode, phoneNumber และ phoneVerificationMethod ไปยัง accounts.requestphoneverification การเรียกนี้จะแสดงผล verificationId

คุณสามารถใช้ช่อง languageCode ที่ไม่บังคับเพื่อยืนยันในภาษาอื่นที่ไม่ใช่ภาษาเริ่มต้น (ภาษาอังกฤษแบบสหรัฐอเมริกา)

คุณสามารถลองยืนยันหมายเลขโทรศัพท์เดียวกันได้สูงสุด 5 ครั้งทุกๆ 4 ชั่วโมง

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

ตัวอย่างการเรียกมีดังนี้

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

ตัวอย่างการตอบกลับมีดังนี้

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

สำคัญ: การเรียกนี้จะส่งรหัสยืนยันไปยังหมายเลขโทรศัพท์ของคุณด้วย คุณต้องใช้รหัสนี้ในขั้นตอนถัดไป

accounts.verifyphonenumber

ยืนยันหมายเลขโทรศัพท์ของบัญชีโดยส่ง verificationId จาก accounts.requestphoneverification, verificationCode 6 หลักที่ส่งไปยัง โทรศัพท์ และ phoneVerificationMethod ที่คุณใช้ เช่น SMS ไปยัง accounts.verifyphonenumber การเรียกนี้จะแสดงผลหมายเลขโทรศัพท์ที่ยืนยันแล้วในรูปแบบมาตรฐานสำหรับภูมิภาคของคุณ

คำขอยืนยันเริ่มต้นจะหมดอายุหลังจากผ่านไป 15 นาที หลังจากนั้น คุณต้องเริ่มคำขอการยืนยันทางโทรศัพท์ใหม่ก่อนที่จะเรียก accounts.verifyphonenumber

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

ตัวอย่างการเรียกมีดังนี้

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

ตัวอย่างการตอบกลับมีดังนี้

{
  "verifiedPhoneNumber": "[phone]"
}

AccountBusinessInformation.phoneVerificationStatus

คุณสามารถตรวจสอบสถานะการยืนยันทางโทรศัพท์ของบัญชีได้ใน AccountBusinessInformation.phoneVerificationStatus

เรียกเมธอด accounts.get ด้วย accountId และ merchantId เพื่อดู ข้อมูลทางธุรกิจของบัญชี:

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