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 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:

  1. 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 ou PHONE_CALL).
  2. 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.

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