Pagbuo ng +592 verification test gamit ang webhook at polling

Paano idisenyo ang webhook-first na Guyana OTP API flow?

Para sa anumang higit pa sa isang beses na check, hayaang ang platform ang magtulak ng mga code sa iyo sa halip na paulit-ulit na magtanong. Sa Developer console, magdagdag ng HTTPS endpoint (maaaring maglaman ng 5 ang isang account) at i-subscribe ito sa activation.sms_received, kasama ang activation.expired at activation.cancelled, para malaman ng test runner mo ang mga dead end nang kasing bilis ng mga tagumpay.

Ituring na hindi mapagkakatiwalaan ang bawat papasok na request hangga't hindi ito pumapasa sa verification:

• Basahin ang X-OTPRoute-Signature header, na may anyong t=<unix>,v1=<hex>.
• Pagdugtungin ang timestamp, isang tuldok at ang hindi binagong request body, pagkatapos ay kalkulahin ang HMAC-SHA256 sa string na iyon gamit ang secret ng endpoint.
• Ihambing ang digest mo sa v1 sa constant time, at itapon ang request kung luma na ang timestamp.
• Hanapin ang activation id sa event; kung naproseso mo na ito, magbalik ng success at wala nang gawin pa.

Ang huling panuntunang iyon ang nagpapanatiling idempotent ng handler, kaya hindi malilito ang test sa muling pagpapadala matapos ang network hiccup. May mas mahabang talakay sa webhook-based OTP capture.

Anong mga endpoint at id ang ginagamit ng +592 na order?

Mag-authenticate gamit ang Bearer key mula sa Developer console; nagsisimula sa or_live_ ang mga live key at hanggang 10 ang puwedeng itago ng bawat account. Ang base URL ay https://otproute.com/api/v1, at ang country id ng Guyana ay gy.

Karaniwang binabasa muna ng isang run ang GET /api/v1/prices?country=gy&service=<id>, dahil live na halaga at hindi pare-pareho ang presyo at availability sa route na ito. Pagkatapos ay magpapadala ito ng POST /api/v1/activations na may {"service": "<id>", "country": "gy"} at makakakuha ng +592 na numero kasama ang activation id. Kung walang webhook, magpo-poll ang runner ng GET /api/v1/activations/{id} kada ilang segundo, malayo sa 300-request-kada-minutong limitasyon. Tatawag ang teardown step ng POST /api/v1/activations/{id}/cancel kapag na-abort ang test, at ang pre-flight na tawag sa GET /api/v1/balance ang magpapahinto nang maaga sa suite kung mababa ang wallet. Galing sa GET /api/v1/services ang mga service id; may mga client example ang developer hub para sa SMS verification API na ito.

Paano ipino-format ang mga +592 na numero para sa storage?

Gumagamit ang Guyana ng country code na 592 at pitong-digit na pambansang numero na walang trunk prefix na aalisin, kaya ang E.164 na anyo ay +592 lang na sinusundan ng pitong digit na iyon. Karaniwang isinusulat ng mga tao ang mga digit bilang grupo ng tatlo at grupo ng apat.

Dahil walang zero sa unahan na aalisin, ang normalisation ay pagtanggal lang ng mga espasyo at gitling at pagdagdag ng country code kapag lokal na digit lang ang tinype ng user. Madalas na bug ang form na nag-aakalang may area code ang bawat numero sa South America, o nagtatakda ng minimum na haba na higit sa pitong digit, kaya tinatanggihan nito ang mga wastong entry ng Guyana. Mabilis itong inilalantad ng +592 na numero para sa testing. I-save ang E.164 na string at ilapat lamang ang lokal na format sa oras ng pagpapakita.

Anong mga serbisyo ang makakatanggap ng Guyana SMS OTP code, at puwede ba akong mag-order nang manu-mano?

Naglilista ang route ng Guyana ng mahigit 900 na serbisyo. Kabilang sa mga madalas hilingin ang WhatsApp, Facebook, Instagram, Google (Gmail & YouTube), TikTok, Telegram, imo, Viber, Snapchat, Amazon, Microsoft & Outlook, Discord, Netflix at Claude. Snapshot ng live na katalogo ang listahang iyon, kaya kumpirmahin sa API o sa dashboard bago magplano ng test sa isang partikular na sender.

Para sa mga kasamahang hindi nagsusulat ng code, ganoon din ang magagawa ng dashboard. Mag-sign in, buksan ang OTP Gateway, piliin ang Guyana at isang serbisyo, tingnan ang presyo, at mag-order. Lalabas ang verification number ng Guyana kasama ang 20-minutong countdown, at ipapakita sa tabi nito ang code pagdating.

Ano ang dapat gawin ng test kapag huli o nawawala ang +592 code?

Nananatiling bukas ang isang activation sa loob ng 20 minuto. Magbabayad ka lamang kung dumating ang code sa loob ng window na iyon; kung mag-expire ito o kinansela mo, ibabalik nang buo sa wallet ang halaga nang walang support ticket.

Makatwirang paghawak sa isang automated na run:

1. Hintayin ang buong window bago ideklarang pumalya, maliban kung may mahigpit na time limit ang test mo, kung saan malinaw na mag-cancel.
2. Subukan muli mamaya, o lumipat sa ibang service route kung may iniaalok ang API.
3. Tingnan kung tumatanggap ng mga virtual number ang target na serbisyo; may ilang tumatanggi, at sakop ng refund ang ganoong kaso.
4. Pagitan-pagitan ang mga retry gamit ang backoff sa halip na muling mag-order sa masikip na loop.

Ipinapaliwanag ng gabay sa country routing para sa OTP kung paano pumili ng mga fallback route.

Bakit sinusubok ng mga team ang mga sign-up flow sa Guyana?

Ang Guyana ang tanging bansa sa South America na English ang opisyal na wika, at nasa Georgetown ang CARICOM Secretariat, kaya madalas itong lumalabas sa mga rollout na itinuturing na iisang merkado ang Caribbean Community. Ang mabilis na lumalagong offshore energy sector ay umakit ng mga internasyonal na kontratista at supplier, habang ang malaking diaspora sa United States, Canada at United Kingdom ay nagpapanatiling aktibo sa mga +592 na numero ang mga remittance, messaging at travel app. Malawakang sinasalita araw-araw ang Guyanese Creole, ngunit karaniwang English ang wika ng mga verification text. Para sa QA, nakatuon ang pagsisikap sa pagpasok ng numero, mga country picker at pananalita ng SMS consent kaysa sa isinaling copy. Panatilihin ang bawat check sa mga account na pag-aari ng organisasyon mo, sundin ang mga tuntunin ng bawat serbisyo, at tandaang sakop ng Acceptable Use Policy ng OTP Route ang lahat ng order.

Maaari ba akong magtago ng linya sa Guyana, at paano sinisingil ang paggamit?

Hindi inaalok ang self-serve na pangmatagalang numero para sa Guyana. Sakop lamang ng Dedicated Numbers ng OTP Route ang United States at Canada, mula $1.95/month. Para sa +592 na linya, mag-email sa [email protected] at titingnan ng team kung ano ang pinapayagan ng lokal na patakaran, nang walang ipinapangakong resulta.

Dumadaan ang pagbabayad sa iisang prepaid na USD wallet: walang buwanang bayad, walang plano, top-up gamit ang card o USDT/USDC, at PDF invoice sa email para sa bawat isa. Kapag hiniling, maaaring ilipat sa sandbox ang development account, kaya tumatakbo ang mga integration test sa mga simulated na numero at code at hindi gumagalaw ang balanse. Makikita ang mga rate kada serbisyo sa pricing page.

Mga madalas itanong

Maaari ko bang suriin ang sign-up ng app ko sa Guyana nang walang SIM mula sa carrier ng Guyana?

Oo. Mag-order ng +592 na numero mula sa OTP Gateway para sa serbisyo mo, ilagay ito sa flow mo, at lalabas ang code sa dashboard o aabot sa webhook mo. Nagsisimula ang presyo sa $0.20 kada code.

Anong country id ang ginagamit ng API para sa Guyana?

gy ito, na ginagamit sa prices query at sa body ng activation request.

Kailangan ko bang tanggalin ang zero sa unahan ng mga numero ng Guyana?

Hindi. Walang trunk prefix ang Guyana, kaya ang E.164 na anyo ay +592 na sinusundan ng pitong-digit na numero.

Anong wika ang gamit ng mga +592 verification message?

Karaniwang English, ang opisyal na wika. Gayunpaman, ang sender ang kumokontrol sa pananalita at maaaring sundin ang language setting ng app.

May refund ba kung hindi nagpadala ng SMS ang serbisyo?

Oo, at awtomatiko ito. Kung lumipas ang 20 minuto nang walang code, o kinansela mo, babalik sa wallet mo ang buong halaga.

Maaari ko bang subukan ang buong integration nang hindi gumagastos?

Hilingin sa support na ilipat sa sandbox ang development account mo. Nagbabalik ito ng mga simulated na numero at code, kaya masusubukan nang buo ang mga API call at webhook.

May pangmatagalang +592 na numero ba?

Hindi bilang self-serve na produkto. Ibinebenta lamang ang Dedicated Numbers sa United States at Canada; mag-email sa [email protected] para magtanong tungkol sa Guyana.

Ang mga pangalan ng serbisyo ay trademark ng kani-kanilang may-ari. Walang kaugnayan ang OTP Route sa kanila. Gamitin nang legal ang mga number at sundin ang mga tuntunin ng bawat serbisyo at ang aming Acceptable Use Policy.