Méthode Call-verify — Autorisation de l'utilisateur par appel

Au lieu d'envoyer un code par SMS, l'utilisateur appelle le numéro qui lui a été attribué. Le simple fait de passer l'appel confirme que l'utilisateur a effectivement accès au numéro de téléphone indiqué.

Comment cela fonctionne

1. Votre site envoie deux paramètres à l'API :

   • le numéro de téléphone de l'utilisateur ;

   • le délai d'attente de l'appel (sessionTtlMs).

2. L'API renvoie un numéro de téléphone à appeler.

   Ce numéro doit être affiché à l'utilisateur sur le site.

3. L'utilisateur appelle ce numéro.

4. Si l'appel arrive dans le délai imparti :

   • l'autorisation est considérée comme réussie ;

   • vous recevez un webhook Appel d'autorisation (Call Verify) avec le statut de réussite.

5. Si l'utilisateur n'appelle pas avant l'expiration de la session :

   • l'autorisation est considérée comme échouée ;

   • vous recevez un webhook avec le statut d'échec.

   • Toutefois, une tentative échouée est également facturée.

Schéma :

Votre site → transmet le numéro de l'utilisateur → reçoit le numéro à appeler → l'affiche à l'utilisateur → l'utilisateur appelle → votre webhook reçoit le résultat de l'autorisation.

curl -X'POST' \'<https://paidmethods.kompaas.tech/api/v2/protected/auth/call-verify>' \ -H'accept: application/json' \ -H'Content-Type: application/json' \ -H'Sec-Fetch-Mode: cors' \ -d'{ "userPhoneNumber": "string", "sessionTtlMs": 1}'

URL de la méthode : https://paidmethods.kompaas.tech/api/v2/protected/auth/call-verify

Requête :

{ "userPhoneNumber": "3612345678", "sessionTtlMs": 100 }

L'API répond :

{ "sessionId": "b803e6e94146_139245", "phoneNumber": "3687654321", "expiresAt": "2026-09-24T07:35:55.665Z" }

L'utilisateur doit donc voir le message suivant :

Appelez le numéro +36 8 765 4321

Après l'appel, votre serveur recevra le résultat via le webhook configuré 'Appel d'autorisation (Call Verify)'.

Important : phoneNumber dans la réponse est le numéro que l'utilisateur doit appeler, tandis que userPhoneNumber dans la requête est le numéro de téléphone de l'utilisateur lui-même.

Exemple de requête réussie.
{
"linkedId": "119-1790236307.926540",
"accountId": 139245,
"occurredAt": "2026-09-24T07:51:47.584Z",
"poolPhoneNumber": "3687654321",
"idempotencyKey": "3780cdc9-014b-4be0-98cb-9cd57cc4f220",
"userPhoneNumber": "3612345678",
"isConfirmed": true,
"eventType": "callVerify",
"sessionId": "9a738796f749_139245",
"callerPhoneNumber": "3612345678"
}

Où :

• isConfirmed: true — l'utilisateur a confirmé le numéro avec succès ;

• callerPhoneNumber — le numéro depuis lequel l'appel a effectivement été passé ;

• userPhoneNumber — le numéro initialement transmis pour vérification ;

• poolPhoneNumber — le numéro que l'utilisateur devait appeler ;

• sessionId — l'identifiant de la session de vérification concernée.

Exemple de requête échouée.
{
"linkedId": null,
"accountId": 139245,
"occurredAt": "2026-09-24T07:35:56.102Z",
"poolPhoneNumber": "3687654321",
"idempotencyKey": "7d29db08-48bd-4926-91ed-c02eae6a0d57",
"userPhoneNumber": "3687654321",
"isConfirmed": false,
"eventType": "callVerify",
"sessionId": "b803e6e94146_139245",
"callerPhoneNumber": null
}

Où :

• isConfirmed: false — la vérification n'a pas été effectuée avec succès ;

• callerPhoneNumber: null — aucun appel de l'utilisateur n'a été reçu ;

• la session s'est terminée en raison de l'expiration du délai.