La verifica telefonica prevede 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 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 con il problema relativo allo stato
dell'account
PENDING_PHONE_VERIFICATION
finché non verifichi un numero di telefono.
Per verificare un numero di telefono è necessario eseguire due passaggi:
- Chiama il numero
accounts.requestphoneverification
per avviare una richiesta di verifica telefonica. - Inserisci il tuo codice regione di due lettere.
- Inserisci il tuo numero di telefono.
- Scegli un metodo di verifica (
SMS
oPHONE_CALL
).
- Chiama il numero
- Chiama il numero
accounts.verifyphonenumber
per verificare il numero di telefono. - Inserisci il valore
verificationId
del passaggio 1. - Inserisci le 6 cifre
verificationCode
inviate al tuo smartphone. - Inserisci il valore
phoneVerificationMethod
utilizzato. - Questa chiamata restituisce
verifiedPhoneNumber
. Questo numero di telefono è ora verificato.
- Chiama il numero
Puoi controllare lo stato della verifica telefonica del tuo account in
AccountBusinessInformation.phoneVerificationStatus
.
accounts.requestphoneverification
Avvia la procedura di verifica del numero di telefono superando
phoneRegionCode
, phoneNumber
e phoneVerificationMethod
in
accounts.requestphoneverification
.
Questa chiamata restituisce un verificationId
.
Puoi utilizzare il campo facoltativo languageCode
per 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 un 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 dell'account trasmettendo il verificationId
da
accounts.requestphoneverification
, il verificationCode
di sei cifre inviato al tuo
telefono e il phoneVerificationMethod
utilizzato, ad esempio SMS
, a
accounts.verifyphonenumber
.
Questa chiamata restituisce il numero di telefono verificato in un formato standard per la tua regione.
La tua richiesta di verifica iniziale scade dopo 15 minuti. Dopodiché,
devi 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
Ecco un 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 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