La verificación telefónica consta de dos
Métodos de cuentas
que puedes usar para agregar y verificar números de teléfono de una cuenta de comerciante.
Los números de teléfono enviados mediante la verificación telefónica reemplazan el teléfono
números que puedas haber enviado a través de
accounts.AccountBusinessInformation
La verificación telefónica es altamente recomendable para todos los teléfonos nuevos y existentes.
comercios. De lo contrario, su cuenta podría suspenderse con la cuenta
estado
emite PENDING_PHONE_VERIFICATION
hasta que verifiques un número de teléfono.
Para verificar un número de teléfono, debes seguir estos dos pasos:
- Llama a
accounts.requestphoneverification
para iniciar una solicitud de verificación telefónica. - Ingresa tu región de dos letras correcto.
- Ingresa tu número de teléfono.
- Elige un método de verificación (
SMS
oPHONE_CALL
).
- Llama a
- Llama a
accounts.verifyphonenumber
para verificar el número de teléfono. - Ingresa el
verificationId
del paso 1. - Ingresa el
verificationCode
de 6 dígitos que enviamos a tu teléfono. - Ingresa los
phoneVerificationMethod
utilizados. - Esta llamada muestra un
verifiedPhoneNumber
. Este número de teléfono ahora es verificados.
- Llama a
Puedes consultar el estado de la verificación telefónica de tu cuenta en
AccountBusinessInformation.phoneVerificationStatus
accounts.requestphoneverification
Comienza el proceso de verificación del número de teléfono pasando el
phoneRegionCode
, phoneNumber
y phoneVerificationMethod
en
accounts.requestphoneverification
.
Esta llamada muestra un verificationId
.
Puedes usar el parámetro
languageCode
para verificarlo en un idioma distinto del predeterminado (inglés de EE.UU.).
Puedes intentar verificar el mismo número de teléfono un máximo de cinco veces cada cuatro horas.
POST https://www.googleapis.com/content/v2.1/merchantId/accounts/accountId/requestphoneverification
Aquí hay una llamada de ejemplo:
{ "phoneRegionCode": "US", "phoneNumber": "phoneNumber", "phoneVerificationMethod": "SMS", "languageCode": "en-US" }
Esta es una respuesta de ejemplo:
{ "verificationId": "2-47b7ef80ff494daf8079f4808e750dcb-1626331725036" }
accounts.verifyphonenumber
Verifica el número de teléfono de la cuenta pasando el verificationId
de
accounts.requestphoneverification
, el verificationCode
de seis dígitos que se envió a tu
teléfono y el phoneVerificationMethod
que usaste, por ejemplo, SMS
, en
accounts.verifyphonenumber
.
Esta llamada muestra el número de teléfono verificado en formato estándar para tu región.
Tu solicitud de verificación inicial vencerá después de 15 minutos. Después de eso,
debe iniciar una nueva solicitud de verificación telefónica antes de llamar
accounts.verifyphonenumber
POST https://www.googleapis.com/content/v2.1/merchantId/accounts/accountId/verifyphonenumber
Aquí hay una llamada de ejemplo:
{ "verificationId": "verificationId", "verificationCode": "verificationCode", "phoneVerificationMethod": "SMS" }
Esta es una respuesta de ejemplo:
{ "verifiedPhoneNumber": "(123) 456-7890" }
AccountBusinessInformation.phoneVerificationStatus
Puedes revisar el estado de la verificación telefónica de tu cuenta en la
AccountBusinessInformation.phoneVerificationStatus
.
Llama al
Método accounts.get
con
un accountId
y un merchantId
para ver los datos de
información de la empresa:
GET https://www.googleapis.com/content/v2.1/v2.1/merchantId/accounts/accountId