Verifica telefonica

La verifica telefonica prevede due metodi relativi agli account che puoi utilizzare per aggiungere e verificare i numeri di telefono di un account commerciante. I numeri di telefono inviati tramite la verifica telefonica sostituiscono i numeri di telefono che potresti aver inviato tramite accounts.AccountBusinessInformation.

La verifica telefonica è vivamente consigliata per tutti i commercianti nuovi ed esistenti. Il tuo account potrebbe essere sospeso in caso di problemi relativi allo stato dell'account PENDING_PHONE_VERIFICATION finché non verifichi un numero di telefono.

Per verificare un numero di telefono è necessario procedere in due modi:

  1. Chiama il numero accounts.requestphoneverification per avviare una richiesta di verifica telefonica.
    Inserisci il codice regione di due lettere.
    Inserisci il tuo numero di telefono.
    Scegli un metodo di verifica (SMS o PHONE_CALL).
  2. Chiama il numero accounts.verifyphonenumber per verificare il numero di telefono.
    Inserisci l'verificationId del passaggio 1.
    Inserisci il numero di 6 cifre verificationCode inviato al tuo telefono.
    Inserisci il valore phoneVerificationMethod utilizzato.
    Questa chiamata restituisce verifiedPhoneNumber. Questo numero di telefono è stato verificato.

Puoi controllare lo stato della verifica telefonica del tuo account in AccountBusinessInformation.phoneVerificationStatus.

accounts.requestphoneverification

Avvia la procedura di verifica del numero di telefono passando i phoneRegionCode, phoneNumber e phoneVerificationMethod in accounts.requestphoneverification. Questa chiamata restituisce un verificationId.

Puoi utilizzare il campo facoltativo languageCode per effettuare la verifica in una lingua diversa da quella predefinita (inglese americano).

Puoi provare a verificare lo stesso numero di telefono massimo cinque volte ogni quattro ore.

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

Esempio di chiamata:

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

Ecco un esempio di risposta:

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

accounts.verifyphonenumber

Verifica il numero di telefono per l'account passando il verificationId da accounts.requestphoneverification, il verificationCode di sei cifre inviato al tuo telefono e il phoneVerificationMethod che hai utilizzato, ad esempio SMS, in accounts.verifyphonenumber. Questa chiamata restituisce il numero di telefono verificato in un formato standard per la tua regione.

La richiesta di verifica iniziale scade dopo 15 minuti. Dopodiché, dovrai avviare una nuova richiesta di verifica telefonica prima di chiamare il numero accounts.verifyphonenumber.

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

Esempio di chiamata:

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

Ecco un esempio di risposta:

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

AccountBusinessInformation.phoneVerificationStatus

Puoi controllare lo stato della verifica telefonica del tuo account nel campo AccountBusinessInformation.phoneVerificationStatus.

Chiama il metodo accounts.get con un accountId e merchantId per visualizzare le informazioni sull'attività del tuo account:

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