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:
- 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
ouPHONE_CALL
).
- Ligue para
- 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.
- Ligue para
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