Verificação por telefone

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

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

  1. Chame accounts.requestphoneverification para iniciar uma solicitação de verificação por telefone.
    Digite o código de região com 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.
    Digite o verificationCode de seis dígitos enviado para seu telefone.
    Digite o phoneVerificationMethod usado.
    Essa chamada retorna um verifiedPhoneNumber. Este número de telefone foi verificado.

Confira o status da verificação de 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 que você usou, 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 de verificação inicial expira após 15 minutos. Depois disso, é necessário 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

É possível conferir o status da verificação de telefone da sua conta no campo AccountBusinessInformation.phoneVerificationStatus.

Chame o método accounts.get com um 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