La verificación telefónica consta de dos
métodos de Accounts
que puedes usar para agregar y verificar números de teléfono para una cuenta de comerciante.
Los números de teléfono enviados a través de la verificación telefónica reemplazan los números de teléfono que hayas enviado a través
accounts.AccountBusinessInformation.
Se recomienda la verificación telefónica para todos los comerciantes 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.
Existen dos pasos obligatorios para verificar un número de teléfono:
- Llama a
accounts.requestphoneverificationpara iniciar una solicitud de verificación telefónica. - Ingresa el código de región de dos letras.
- Ingresa tu número de teléfono.
- Elige un método de verificación (
SMSoPHONE_CALL).
- Llama a
- Llama a
accounts.verifyphonenumberpara verificar el número de teléfono. - Ingresa el
verificationIddel paso 1. - Ingresa el
verificationCodede 6 dígitos que se envió a tu teléfono. - Ingresa el
phoneVerificationMethodque usaste. - Esta llamada devuelve un
verifiedPhoneNumber. Ahora se verificó este número de teléfono.
- Llama a
Puedes consultar 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 el
phoneRegionCode, phoneNumber y phoneVerificationMethod a
accounts.requestphoneverification.
Esta llamada devuelve unverificationId.
Puedes usar el campo opcional
languageCode
para verificar 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
A continuación, se muestra 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 devuelve el número de teléfono verificado en un formato estándar para tu región.
Tu solicitud de verificación inicial vence después de 15 minutos. Después de eso, debes iniciar una nueva solicitud de verificación telefónica antes de llamar a accounts.verifyphonenumber.
POST https://www.googleapis.com/content/v2.1/merchantId/accounts/accountId/verifyphonenumber
A continuación, se muestra una llamada de ejemplo:
{
"verificationId": "verificationId",
"verificationCode": "verificationCode",
"phoneVerificationMethod": "SMS"
}Esta es una respuesta de ejemplo:
{
"verifiedPhoneNumber": "(123) 456-7890"
}AccountBusinessInformation.phoneVerificationStatus
Puedes consultar el estado de la verificación telefónica de tu cuenta en el
AccountBusinessInformation.phoneVerificationStatus
campo.
Llama al
accounts.get método con
un accountId y 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