Verificación telefónica

La verificación telefónica consta de dos métodos de Accounts que puedes usar para agregar y verificar números de teléfono de una cuenta de comerciante. Los números de teléfono que se envían a través de la verificación telefónica reemplazan a los que se envían 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.

Existen dos pasos obligatorios para verificar un número de teléfono:

1. Llama a accounts.requestphoneverification para 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 (SMS o PHONE_CALL).

2. Llama al accounts.verifyphonenumber para verificar el número de teléfono.

   Ingresa el verificationId del paso 1.

   Ingresa el código de 6 dígitos verificationCode que se envió a tu teléfono.

   Ingresa el phoneVerificationMethod que se usó.

   Esta llamada devuelve un verifiedPhoneNumber. Ahora este número de teléfono está verificado.

Puedes verificar 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 devuelve un objeto verificationId.

Puedes usar el campo opcional languageCode para realizar la verificación 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

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

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 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 verificar 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 un 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