Verificação por telefone

A verificação por telefone consiste em dois métodos de contas que você pode usar 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 enviados por accounts.AccountBusinessInformation.

A verificação por telefone é altamente recomendada para todos os comerciantes novos e existentes. Sua conta pode 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 para iniciar uma solicitação de verificação por telefone.
    Digite seu código da 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.
    Digite o verificationCode de seis dígitos enviado ao seu smartphone.
    Insira o phoneVerificationMethod usado.
    Essa chamada retorna um verifiedPhoneNumber. Esse número de telefone foi verificado.

Você pode conferir 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 uma verificationId.

Use o campo opcional languageCode para fazer a verificação em um idioma diferente do padrão (inglês americano).

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

Este é 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 ao smartphone e o phoneVerificationMethod usado, por exemplo, SMS, para accounts.verifyphonenumber. Esta chamada retorna o número de telefone verificado em um formato padrão para sua região.

Seu pedido de verificação inicial expira em 15 minutos. Depois disso, será 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

Este é 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 ver as informações comerciais da sua conta:

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