Metóda Call-verify — Autorizácia používateľa prostredníctvom hovoru

Namiesto odoslania SMS kódu používateľ zavolá na pridelené číslo. Samotné uskutočnenie hovoru potvrdzuje, že používateľ má skutočne prístup k uvedenému telefónnemu číslu.

Ako to funguje

1. Vaša stránka odošle API dva parametre:

   • telefónne číslo používateľa;

   • čas, počas ktorého sa má čakať na hovor (sessionTtlMs).

2. API vráti telefónne číslo, na ktoré má používateľ zavolať.

   Toto číslo je potrebné zobraziť používateľovi na stránke.

3. Používateľ zavolá na toto číslo.

4. Ak hovor príde v stanovenom čase:

   • autorizácia sa považuje za úspešnú;

   • dostanete webhook Autorizančný hovor (Call Verify) so stavom úspechu.

5. Ak používateľ nezavolá pred uplynutím času relácie:

   • autorizácia sa považuje za neúspešnú;

   • dostanete webhook so stavom neúspechu.

   • Pritom sa neúspešný pokus tiež účtuje.

Schéma:

Vaša stránka → odošle číslo používateľa → dostane číslo na zavolanie → zobrazí ho používateľovi → používateľ zavolá → váš webhook dostane výsledok autorizácie.

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 metódy : https://paidmethods.kompaas.tech/api/v2/protected/auth/call-verify

Požiadavka:

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

API odpovedá:

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

To znamená, že používateľovi je potrebné zobraziť:

Zavolajte na číslo +36 8 765 4321

Po uskutočnení hovoru váš server dostane výsledok prostredníctvom nastaveného webhooku 'Autorizančný hovor (Call Verify)'.

Dôležité: phoneNumber v odpovedi je číslo, na ktoré používateľ volá, zatiaľ čo userPhoneNumber v požiadavke je číslo samotného používateľa.

Príklad úspešnej požiadavky.
{
"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"
}

Kde:

• isConfirmed: true — používateľ úspešne potvrdil číslo;

• callerPhoneNumber — číslo, z ktorého bol hovor skutočne uskutočnený;

• userPhoneNumber — číslo, ktoré bolo pôvodne odoslané na overenie;

• poolPhoneNumber — číslo, na ktoré mal používateľ zavolať;

• sessionId — identifikátor konkrétnej relácie overenia.

Príklad neúspešnej požiadavky.
{
"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
}

Kde:

• isConfirmed: false — overenie nebolo úspešné;

• callerPhoneNumber: null — používateľ neuskutočnil hovor;

• relácia sa ukončila po uplynutí časového limitu.