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 de la validation remplacent les numéros de téléphone que vous avez peut-être envoyés via accounts.AccountBusinessInformation.

Nous recommandons vivement à tous les marchands (nouveaux ou non) de valider leur numéro de téléphone. Sans cela, 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 le verificationId de l'étape 1.
    Saisissez le verificationCode à six chiffres envoyé sur votre téléphone.
    Saisissez la phoneVerificationMethod utilisée.
    Cet appel doit renvoyer la réponse verifiedPhoneNumber. Le numéro de téléphone est maintenant 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 du numéro de téléphone en transmettant le phoneRegionCode, le phoneNumber et la phoneVerificationMethod à accounts.requestphoneverification. Cet appel doit renvoyer la réponse 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 cinq fois maximum 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 du compte en transmettant le verificationId de accounts.requestphoneverification, le verificationCode à six chiffres envoyé sur votre téléphone et la phoneVerificationMethod que vous avez utilisée (par exemple, SMS) à accounts.verifyphonenumber. 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 AccountBusinessInformation.phoneVerificationStatus champ.

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

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