Pagte-test ng +27 Verification Flow: Checklist para sa mga South African na Paglulunsad

Bago ang unang +27 order: maikling listahan ng paghahanda

Markahan ang mga ito at dapat dumaan nang walang sorpresa ang una ninyong South African na activation:

1. Napondohan ang wallet. Isang prepaid USD wallet ang nagpopondo sa lahat; i-load ito gamit ang card o USDT/USDC. Walang subscription.
2. Naibigay na ang key. Gumawa ng Bearer key sa Developer console (nagsisimula ito sa or_live_). Magkaroon ng magkahiwalay na key para sa CI at para sa staging, hanggang 10 sa kabuuan.
3. Nairehistro ang webhook. Magdagdag ng HTTPS endpoint at itabi ang signing secret nito. Hanggang lima ang puwede ninyong irehistro.
4. Nasubukan na ang number normalizer. Pakainin ito ng input na istilong 082 123 4567 at kumpirmahing gumagawa ito ng +2782... na natanggal ang nangungunang 0.
5. Kumpirmado ang service id. Kunin ang catalog mula sa GET /api/v1/services sa halip na manghula ng mga id.
6. Opsyonal ang sandbox. Maaaring ilipat ng support ang isang development account sa sandbox para dumaloy sa code ninyo ang mga simulated na numero at code bago ang anumang totoong gastos.

Ipinapakita ng gabay sa CI testing kung paano ikabit ang mga piyesang ito sa isang pipeline.

Paano dapat itabi at i-normalize ang mga numero ng South Africa?

Gumagamit ang South Africa ng trunk prefix na 0. Ang mobile number na isinulat nang lokal ay may sampung digit, gaya ng 082 123 4567, at karaniwang nagsisimula sa 06, 07 o 08 ang mga mobile range sa national form na iyon. Sa international format, nawawala ang 0: ang parehong linya ay nagiging +27 82 123 4567, o +27821234567 kapag inalis ang mga espasyo, na siyam na digit pagkatapos ng country code.

Ang klasikong bug ay isang nakaimbak na halagang gaya ng +270821234567, na nagagawa kapag idinidikit ng form ang country code sa lokal na numero nang hindi inaalis ang 0. I-normalize sa input, itabi lamang ang E.164, at i-render ang lokal na format na may espasyo para sa display lang. Kung kayo mismo ang nagpapadala ng outbound SMS, pinananatili ng parehong patakaran na pare-pareho ang mga delivery report at user lookup.

Aling mga serbisyo ang makapagpapadala ng code sa South Africa verification number?

Kabilang sa mga sikat na route para sa za ngayon ang WhatsApp, Facebook, Instagram, TikTok, Google (Gmail & YouTube), Uber, Telegram, Microsoft & Outlook, LinkedIn, Netflix, Amazon, X (Twitter), ChatGPT (OpenAI) at Discord. Sa buong catalog, sinusuportahan ng bansa ang mahigit 1,700 serbisyo, at dahil gumagalaw ang inventory sa buong araw, ang API ang lugar para basahin ang kasalukuyang availability.

Bakit pinipili ng mga team ang market na ito? Matatag nang tech at finance hub ang Johannesburg at Cape Town, at maraming kumpanya ang gumagamit sa South Africa bilang base ng mas malawak na paglulunsad sa Southern Africa. May ilang opisyal na wika ang bansa, kabilang ang English, isiZulu, isiXhosa at Afrikaans, pero karamihan ng verification message ay dumarating sa English, kaya ang localization QA ay kadalasang nakatuon sa mga nakapaligid na screen kaysa sa mismong teksto ng SMS.

Mga hakbang: pagtawag sa South Africa OTP API mula sa test harness ninyo

Pumupunta ang mga request sa https://otproute.com/api/v1 na may Bearer key ninyo, hanggang 300 kada minuto.

1. Ibinabalik ng GET /api/v1/prices?country=za&service=<id> ang live na presyo para sa pares na gusto ninyo.
2. Ang POST /api/v1/activations na may {"service": "<id>", "country": "za"} ay nagrereserba ng +27 number at nagbabalik ng activation id.
3. Ilalagay ng test ninyo ang numero sa app at ita-trigger ang SMS.
4. Darating sa webhook ninyo ang activation.sms_received event. Bago ito pagkatiwalaan, buuin muli ang HMAC-SHA256 ng <t>.<raw body> gamit ang secret ng endpoint, ikumpara sa v1 sa X-OTPRoute-Signature, at itapon ang mga request na masyadong luma ang timestamp.
5. Mas gusto ang polling? Basahin ang GET /api/v1/activations/{id} sa mahinahong pagitan.
6. Dapat tumawag ng POST /api/v1/activations/{id}/cancel ang mga inabandonang takbo, at hinahayaan ng GET /api/v1/balance na huminto nang maaga ang isang job kapag paubos na ang pondo.

Mas marami pang tungkol sa mga pagpili ng routing ang nasa country routing para sa OTP.

Mga hakbang para sa operations staff na gumagamit ng dashboard

Walang kailangang code: buksan ang OTP Gateway, piliin ang South Africa at ang serbisyo, tingnan ang ipinapakitang presyo, kumpirmahin, at i-paste ang +27 number sa app. Lilitaw ang SMS sa activation page sa pagdating nito, at ang 20 minutong window at awtomatikong refund ay gumagana nang eksakto tulad ng sa API.

Pag-troubleshoot ng mga natigil na South African na code

Una, ang tungkol sa pera: kung walang SMS na dumating sa loob ng 20 minuto, o nag-cancel kayo, awtomatikong babalik sa wallet ang buong halaga. Pagkatapos, mag-diagnose:

• Pasensya muna. Nakadepende sa serbisyo at sa route ang bilis ng delivery, kaya hayaang matapos ang activation.
• Patakaran sa pagtanggap. May mga serbisyong tumatanggi sa mga virtual number; inaasahang asal ang refund sa ganoong kaso, hindi sira.
• Ibang oras o route. Subukan muli mamaya, o gumamit ng katabing route gaya ng Namibia o Botswana kung pinapayagan ng test case.
• Huwag kalampagin. Bihirang makatulong ang paulit-ulit na pag-cancel at pag-reorder sa masikip na loop, at ubos ito sa rate limit ninyo.

Gamitin ang mga numero para lang subukan ang sarili ninyong produkto o patakbuhin ang sarili ninyong business account, igalang ang mga tuntunin ng bawat serbisyo, at tandaang umiiral ang Acceptable Use Policy ng OTP Route.

Mga pangmatagalang South African na linya at ang billing model

Walang self-serve na pangmatagalang +27 number. Iniaalok lamang ang mga Dedicated Number, mula $1.95/month, sa United States at Canada; maaaring mag-email sa [email protected] ang mga team na nangangailangan ng permanenteng South African na linya, at nakadepende sa lokal na patakaran kung posible ito. Pay as you go ang billing mula sa prepaid wallet, na may PDF invoice sa email para sa bawat top-up. Tingnan ang pricing para sa buong larawan.

Mga madalas itanong

Puwede ko bang subukan ang South African na sign-up flow ng app ko nang walang lokal na SIM?

Oo. Mag-order ng +27 number sa OTP Gateway at basahin ang code sa dashboard o sa API. Mula $0.20 bawat code ang halaga, at kapag dumating lang ang code.

Pinapanatili ko ba ang nangungunang 0 kapag kino-convert ang South African na numero sa E.164?

Hindi. Alisin ang trunk na 0 at lagyan ng prefix na +27, kaya ang 082 123 4567 ay nagiging +27821234567.

Ano ang API country id ng South Africa?

Ito ay za, na inilalagay sa price query at sa JSON body kapag gumagawa ng +27 activation.

Anong wika ang ginagamit ng mga South African na verification text?

Karamihan ay English, kahit may ilang opisyal na wika ang bansa. Ang nagpapadalang serbisyo ang nagpapasya ng pananalita.

May refund ba kung hindi kailanman naihatid ang code?

Oo. Bukas ang activation sa loob ng 20 minuto, at kung walang dumating o nag-cancel kayo, awtomatikong babalik sa wallet ang buong halaga.

Puwede ba akong bumili ng South African na numero na itatabi ko nang ilang buwan?

Hindi self-serve. Produkto ng US at Canada ang mga Dedicated Number; para sa South Africa, mag-email sa support para magtanong, nang walang pangakong availability.

Ilang serbisyo ang mabe-verify ko gamit ang +27 number sa OTP Route?

Mahigit 1,700 sa pinakahuling snapshot. Tingnan ang live na catalog sa API, dahil nagbabago ang availability sa buong araw.

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.