Verificação por telefone

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 de 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 status da conta PENDING_PHONE_VERIFICATION até que você verifique um número de telefone.

Há duas etapas obrigatórias para verificar um número de telefone:

  1. Ligue para accounts.requestphoneverification para iniciar uma solicitação de verificação por telefone.
    Insira o código de região de duas letras.
    Digite seu número de telefone.
    Escolha um método de verificação (SMS ou PHONE_CALL).
  2. Ligue para accounts.verifyphonenumber para verificar o número de telefone.
    Insira o verificationId da etapa 1.
    Insira o verificationCode de seis dígitos enviado para seu smartphone.
    Insira o phoneVerificationMethod usado.
    Essa chamada retorna um verifiedPhoneNumber. Este número de telefone foi verificado.

Você pode verificar 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.

É possível usar o campo opcional languageCode para verificar 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

Confira 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 de accounts.requestphoneverification, o verificationCode de seis dígitos enviado para seu telefone e o phoneVerificationMethod usado, por exemplo, SMS, para accounts.verifyphonenumber. Essa chamada retorna o número de telefone verificado em um formato padrão para sua região.

Sua solicitação inicial de verificação expira após 15 minutos. Depois disso, você precisa iniciar uma nova solicitação de verificação por telefone antes de chamar accounts.verifyphonenumber.

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

Confira um exemplo de chamada:

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

Veja um exemplo de resposta:

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

AccountBusinessInformation.phoneVerificationStatus

Você pode verificar o status da verificação por telefone da sua conta no campo AccountBusinessInformation.phoneVerificationStatus.

Chame o método accounts.get com um accountId e um merchantId para conferir as informações comerciais da conta:

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