Verifica telefonica

La verifica telefonica è costituita da due metodi di 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 quelli che potresti aver inviato tramite accounts.AccountBusinessInformation.

La verifica telefonica è fortemente consigliata per tutti i commercianti nuovi ed esistenti. In caso contrario, il tuo account potrebbe essere sospeso con il problema di stato dell'account PENDING_PHONE_VERIFICATION finché non verifichi un numero di telefono.

Per verificare un numero di telefono sono necessari due passaggi:

  1. Chiama 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 accounts.verifyphonenumber per verificare il numero di telefono.
    Inserisci il verificationId del passaggio 1.
    Inserisci il verificationCode a 6 cifre inviato al tuo telefono.
    Inserisci il phoneVerificationMethod utilizzato.
    Questa chiamata restituisce un verifiedPhoneNumber. Il numero di telefono è ora 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 il phoneRegionCode, phoneNumber e phoneVerificationMethod a accounts.requestphoneverification. Questa chiamata restituisce un verificationId.

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

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

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

Ecco una chiamata di esempio:

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

Ecco una risposta di esempio:

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

accounts.verifyphonenumber

Verifica il numero di telefono dell'account passando il verificationId da accounts.requestphoneverification, il verificationCode a sei cifre inviato al tuo telefono e il phoneVerificationMethod che hai utilizzato, ad esempio SMS, a 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é, devi avviare una nuova richiesta di verifica telefonica prima di chiamare accounts.verifyphonenumber.

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

Ecco una chiamata di esempio:

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

Ecco una risposta di esempio:

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

AccountBusinessInformation.phoneVerificationStatus

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

Chiama il accounts.get metodo 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