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 comercio.
Los números de teléfono enviados con la verificación telefónica reemplazan a los números de teléfono que puedas haber enviado a través de accounts.AccountBusinessInformation
.
Se recomienda la verificación telefónica para todos los comercios nuevos y existentes. De lo contrario, es posible que se suspenda tu cuenta con el problema de estado de la cuenta 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 el código de la región de dos letras.
- 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 la
phoneVerificationMethod
que se usó. - Esta llamada muestra un
verifiedPhoneNumber
. Este número de teléfono ya está verificado.
- Llama a
Puedes comprobar el estado de la verificación telefónica de tu cuenta en AccountBusinessInformation.phoneVerificationStatus
.
accounts.requestphoneverification
Para iniciar el proceso de verificación del número de teléfono, pasa phoneRegionCode
, phoneNumber
y phoneVerificationMethod
a accounts.requestphoneverification
.
Esta llamada muestra un verificationId
.
Puedes usar el campo opcional languageCode
para realizar la verificación en un idioma que no sea el 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
Para verificar el número de teléfono de la cuenta, pasa 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
, a 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. Luego, deberás iniciar una nueva solicitud de verificación por teléfono antes de llamar a 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 comprobar el estado de la verificación telefónica de tu cuenta en el campo AccountBusinessInformation.phoneVerificationStatus
.
Llama al método accounts.get
con un accountId
y una merchantId
para ver la información de la empresa de tu cuenta:
GET https://www.googleapis.com/content/v2.1/v2.1/merchantId/accounts/accountId