Call-verify módszer — Felhasználó hitelesítése hívással

Az SMS-kód elküldése helyett a felhasználó felhívja a számára megadott telefonszámot. Maga a hívás ténye megerősíti, hogy a felhasználó valóban hozzáfér a megadott telefonszámhoz.

Hogyan működik

1. Az Ön webhelye két paramétert küld az API-nak:

   • a felhasználó telefonszámát;

   • azt az időtartamot, ameddig a hívásra várni kell (sessionTtlMs).

2. Az API visszaadja a híváshoz szükséges telefonszámot.

   Ezt a számot meg kell jeleníteni a felhasználónak a webhelyen.

3. A felhasználó felhívja ezt a számot.

4. Ha a hívás a rendelkezésre álló időn belül beérkezik:

   • a hitelesítés sikeresnek minősül;

   • Ön megkapja a 'Hitelesítési hívás (Call Verify)' webhookot sikeres státusszal.

5. Ha a felhasználó nem hív a munkamenet lejárta előtt:

   • a hitelesítés sikertelennek minősül;

   • Ön megkapja a webhookot sikertelen státusszal.

   • Ebben az esetben a sikertelen próbálkozás is díjköteles.

Séma:
Az Ön webhelye → továbbítja a felhasználó telefonszámát → megkapja a híváshoz szükséges telefonszámot → megjeleníti azt a felhasználónak → a felhasználó felhívja a számot → az Ön webhookja megkapja a hitelesítés eredményét.

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}'

A metódus URL-je : https://paidmethods.kompaas.tech/api/v2/protected/auth/call-verify

Kérés:

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

Az API válasza:

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

Vagyis a felhasználónak ezt kell megjeleníteni:

Hívja a +36 8 765 4321 telefonszámot

A hívás után az Ön szervere az eredményt a beállított 'Hitelesítési hívás (Call Verify)' webhookon keresztül kapja meg.

Fontos: a válaszban szereplő phoneNumber az a telefonszám, amelyet a felhasználónak fel kell hívnia, míg a kérésben szereplő userPhoneNumber magának a felhasználónak a telefonszáma.

Példa sikeres kérésre.
{
"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"
}

Ahol:

• isConfirmed: true — a felhasználó sikeresen megerősítette a telefonszámát;

• callerPhoneNumber — az a telefonszám, amelyről a hívás ténylegesen beérkezett;

• userPhoneNumber — az a telefonszám, amelyet eredetileg ellenőrzésre továbbítottak;

• poolPhoneNumber — az a telefonszám, amelyet a felhasználónak fel kellett hívnia;

• sessionId — az adott ellenőrzési munkamenet azonosítója.

Példa sikertelen kérésre.
{
"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
}

Ahol:

• isConfirmed: false — az ellenőrzés sikertelen;

• callerPhoneNumber: null — nem érkezett hívás a felhasználótól;

• a munkamenet időtúllépés miatt lezárult.