אימות טלפוני

אימות טלפוני מורכב משתי שיטות שבהן אפשר להשתמש בחשבון כדי להוסיף ולאמת מספרי טלפון לחשבון של מוכר. מספרי טלפון שנשלחים דרך אימות טלפוני מחליפים את מספרי הטלפון ששלחתם דרך accounts.AccountBusinessInformation.

אימות טלפוני מומלץ מאוד לכל המוכרים החדשים והקיימים. אחרת, יכול להיות שהחשבון יושעה עם הבעיה PENDING_PHONE_VERIFICATION בסטטוס החשבון עד שתאמתו מספר טלפון.

כדי לאמת מספר טלפון, צריך לבצע שני שלבים:

  1. כדי להגיש בקשה לאימות טלפוני, צריך להתקשר למספר accounts.requestphoneverification.
    מזינים את קוד האזור בן שתי האותיות.
    מזינים את מספר הטלפון.
    בוחרים שיטת אימות (SMS או PHONE_CALL).
  2. כדי לאמת את מספר הטלפון, צריך להתקשר אל accounts.verifyphonenumber.
    מזינים את verificationId משלב 1.
    מזינים את 6 הספרות של verificationCode שנשלחה לטלפון.
    מזינים את הערך phoneVerificationMethod שבשימוש.
    השיחה מחזירה verifiedPhoneNumber. מספר הטלפון הזה מאומת עכשיו.

אפשר לבדוק את סטטוס האימות הטלפוני של החשבון ב-AccountBusinessInformation.phoneVerificationStatus.

accounts.requestphoneverification

כדי להתחיל את תהליך האימות של מספר הטלפון, מעבירים את השדות phoneRegionCode, phoneNumber ו-phoneVerificationMethod אל accounts.requestphoneverification. השיחה מחזירה verificationId.

אפשר להשתמש בשדה האופציונלי languageCode כדי לאמת בשפה שאינה ברירת המחדל (אנגלית ארה"ב).

תוכלו לנסות לאמת את אותו מספר טלפון עד חמש פעמים בכל ארבע שעות.

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

כדי לאמת את מספר הטלפון של החשבון, צריך להעביר אל accounts.verifyphonenumber את verificationId מ-accounts.requestphoneverification, את verificationCode בן 6 הספרות שנשלח לטלפון שלך ואת phoneVerificationMethod שבו השתמשת, למשל SMS. השיחה מחזירה את מספר הטלפון המאומת בפורמט רגיל בהתאם לאזור שלכם.

התוקף של בקשת האימות הראשונית יפוג אחרי 15 דקות. לאחר מכן צריך להגיש בקשה חדשה לאימות הטלפוני לפני התקשרות ל-accounts.verifyphonenumber.

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

שיחה לדוגמה:

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

תגובה לדוגמה:

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

AccountBusinessInformation.phoneVerificationStatus

אפשר לבדוק את הסטטוס של האימות הטלפוני בחשבון בשדה AccountBusinessInformation.phoneVerificationStatus.

מפעילים את השיטה accounts.get עם accountId ו-merchantId כדי להציג את פרטי העסק של החשבון:

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