Validation du numéro de téléphone

Pour valider un numéro de téléphone, vous devez appeler deux méthodes Accounts qui vous permettent d'ajouter des numéros de téléphone à un compte marchand et de les valider. Les numéros de téléphone envoyés lors du processus de validation remplacent ceux que vous avez renseignés via accounts.AccountBusinessInformation, le cas échéant.

Nous recommandons vivement à tous les marchands (nouveaux ou non) de valider leur numéro de téléphone, sans quoi leur compte risque d'être suspendu. L'état du compte affichera PENDING_PHONE_VERIFICATION tant que vous n'aurez pas validé un numéro de téléphone.

Pour valider un numéro de téléphone, vous devez suivre deux étapes :

  1. Appelez accounts.requestphoneverification pour lancer le processus de demande de validation des numéros de téléphone.
    Saisissez votre code régional composé de deux lettres.
    Saisissez votre numéro de téléphone.
    Choisissez une méthode de validation (SMS ou PHONE_CALL).
  2. Appelez accounts.verifyphonenumber pour valider le numéro de téléphone.
    Saisissez l'identifiant verificationId obtenu lors de la première étape.
    Saisissez le code à six chiffres verificationCode que vous avez reçu sur votre téléphone.
    Saisissez la méthode phoneVerificationMethod utilisée.
    Cet appel doit renvoyer la réponse verifiedPhoneNumber. Cela signifie que le numéro de téléphone a bien été validé.

Vous pouvez vérifier l'état de la validation du numéro de téléphone de votre compte dans AccountBusinessInformation.phoneVerificationStatus.

accounts.requestphoneverification

Lancez le processus de validation des numéros de téléphone en transmettant les valeurs phoneRegionCode, phoneNumber et phoneVerificationMethod via accounts.requestphoneverification. Cet appel renvoie un identifiant verificationId.

Vous pouvez utiliser le champ facultatif languageCode pour valider le numéro de téléphone dans une langue autre que celle définie par défaut, à savoir l'anglais américain.

Vous pouvez essayer de valider le même numéro de téléphone au maximum cinq fois toutes les quatre heures.

POST https://www.googleapis.com/content/v2.1/merchantId/accounts/accountId/requestphoneverification

Voici un exemple d'appel :

{
  "phoneRegionCode": "US",
  "phoneNumber": "phoneNumber",
  "phoneVerificationMethod": "SMS",
  "languageCode": "en-US"
}

Voici un exemple de réponse :

{
  "verificationId": "2-47b7ef80ff494daf8079f4808e750dcb-1626331725036"
}

accounts.verifyphonenumber

Validez le numéro de téléphone associé au compte en transmettant via accounts.verifyphonenumber l'identifiant verificationId obtenu avec accounts.requestphoneverification, le code à six chiffres verificationCode reçu sur votre téléphone et la méthode phoneVerificationMethod que vous avez utilisée (par exemple, SMS). Cet appel renvoie le numéro de téléphone validé au format standard applicable à votre région.

La demande de validation expire au bout de 15 minutes. Passé ce délai, vous devrez lancer une nouvelle fois le processus de validation avant d'appeler accounts.verifyphonenumber.

POST https://www.googleapis.com/content/v2.1/merchantId/accounts/accountId/verifyphonenumber

Voici un exemple d'appel :

{
  "verificationId": "verificationId",
  "verificationCode": "verificationCode",
  "phoneVerificationMethod": "SMS"
}

Voici un exemple de réponse :

{
  "verifiedPhoneNumber": "(123) 456-7890"
}

AccountBusinessInformation.phoneVerificationStatus

Vous pouvez vérifier l'état de la validation du numéro de téléphone de votre compte dans le champ AccountBusinessInformation.phoneVerificationStatus.

Appelez la méthode accounts.get avec un accountId et un merchantId pour afficher les informations sur l'entreprise pour votre compte :

GET https://www.googleapis.com/content/v2.1/v2.1/merchantId/accounts/accountId