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 de telefone substituem os números que você enviou por accounts.AccountBusinessInformation.

A verificação de 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ê 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 de telefone.
    Insira o código de região de duas letras.
    Insira seu número de telefone.
    Escolha um método de verificação (SMS ou PHONE_CALL).
  2. Chame 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 telefone.
    Insira o phoneVerificationMethod usado.
    Essa chamada retorna um verifiedPhoneNumber. Esse número de telefone agora está verificado.

Você pode verificar 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 o phoneRegionCode, phoneNumber e phoneVerificationMethod para accounts.requestphoneverification. Essa chamada retorna um verificationId.

Você pode 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 de verificação inicial expira após 15 minutos. Depois disso, você precisa iniciar 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

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 de telefone da sua conta no AccountBusinessInformation.phoneVerificationStatus campo.

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