A verificação por telefone consiste em dois métodos de contas que podem ser usados para adicionar e verificar números de telefone de uma conta do comerciante.
Os números de telefone enviados pela verificação por telefone substituem os números
que você enviou pelo
accounts.AccountBusinessInformation
.
A verificação por telefone é altamente recomendada para todos os comerciantes, novos e atuais. Caso contrário, sua conta poderá ser suspensa com o problema de status da conta PENDING_PHONE_VERIFICATION
até que você confirme um número de telefone.
Há duas etapas necessárias para verificar um número de telefone:
- Ligue para
accounts.requestphoneverification
e solicite a verificação por telefone. - Insira seu código de região de duas letras.
- Digite seu número de telefone.
- Escolha um método de verificação (
SMS
ouPHONE_CALL
).
- Ligue para
- Ligue para
accounts.verifyphonenumber
para confirmar o número de telefone. - Insira o
verificationId
da etapa 1. - Digite o
verificationCode
de seis dígitos enviado para seu smartphone. - Informe o valor de
phoneVerificationMethod
usado. - Essa chamada retorna um
verifiedPhoneNumber
. Este número de telefone foi verificado.
- Ligue para
Confira o status da verificação por telefone da sua conta em
AccountBusinessInformation.phoneVerificationStatus
.
accounts.requestphoneverification
Inicie o processo de verificação do número de telefone transmitindo
phoneRegionCode
, phoneNumber
e phoneVerificationMethod
para
accounts.requestphoneverification
.
Essa chamada retorna um verificationId
.
Use o campo opcional languageCode
para fazer a verificação em um idioma diferente do padrão (inglês dos EUA).
Você pode tentar verificar o mesmo número de telefone no máximo cinco vezes a cada quatro horas.
POST https://www.googleapis.com/content/v2.1/merchantId/accounts/accountId/requestphoneverification
Veja um exemplo de chamada:
{ "phoneRegionCode": "US", "phoneNumber": "phoneNumber", "phoneVerificationMethod": "SMS", "languageCode": "en-US" }
Veja um exemplo de resposta:
{ "verificationId": "2-47b7ef80ff494daf8079f4808e750dcb-1626331725036" }
accounts.verifyphonenumber
Verifique o número de telefone da conta transmitindo o verificationId
do
accounts.requestphoneverification
, o verificationCode
de seis dígitos enviado ao
smartphone e o phoneVerificationMethod
que você usou, por exemplo, SMS
, para
accounts.verifyphonenumber
.
Esta chamada retorna o número de telefone confirmado em um formato padrão para sua região.
Sua solicitação de verificação inicial expira em 15 minutos. Depois disso,
inicie uma nova solicitação de verificação de telefone antes de chamar
accounts.verifyphonenumber
.
POST https://www.googleapis.com/content/v2.1/merchantId/accounts/accountId/verifyphonenumber
Veja um exemplo de chamada:
{ "verificationId": "verificationId", "verificationCode": "verificationCode", "phoneVerificationMethod": "SMS" }
Veja um exemplo de resposta:
{ "verifiedPhoneNumber": "(123) 456-7890" }
AccountBusinessInformation.phoneVerificationStatus
Confira o status da verificação por telefone da sua conta no
campo
AccountBusinessInformation.phoneVerificationStatus
.
Chame o método
accounts.get
com
accountId
e merchantId
para conferir as
informações comerciais da sua conta:
GET https://www.googleapis.com/content/v2.1/v2.1/merchantId/accounts/accountId