คู่มือ API OTP เซาตูเมและปรินซิปี (+239)

ทำไมทีมผลิตภัณฑ์จึงควรทดสอบในเซาตูเมและปรินซิปี

หมู่เกาะนี้เป็นหนึ่งในตลาดที่เล็กที่สุดของแอฟริกา แต่สำคัญกับทุกผลิตภัณฑ์ที่ให้บริการโลกที่พูดภาษาโปรตุเกส ทีมที่เปิดตัวทั่วแอฟริกาลูโซโฟน หรือรองรับลูกค้าที่เดินทางระหว่างหมู่เกาะ โปรตุเกส และแองโกลา ต้องเห็นว่าหมายเลข +239 ผ่านฟอร์มสมัครของตน และข้อความภาษาโปรตุเกสอ่านได้ถูกต้อง

ภาษาโปรตุเกสเป็นภาษาราชการ และข้อความยืนยันจากแอประหว่างประเทศมักมาเป็นภาษาโปรตุเกสหรือภาษาอังกฤษตามการตั้งค่าบัญชี ภาษาครีโอลท้องถิ่นอย่างฟอร์โรมีผู้พูดแพร่หลายแต่แทบไม่ปรากฏใน SMS อัตโนมัติ

ยังมีเหตุผลเชิงปฏิบัติอื่นอีก องค์กรพัฒนาเอกชน หน่วยงานพัฒนา และนายจ้างแบบรีโมตเป็นหลักที่มีพนักงานบนเกาะเซาตูเมหรือปรินซิปีมักต้องยืนยันว่าการออนบอร์ดทำงานบนหมายเลขท้องถิ่น และทีมฟินเทคที่ขยายเส้นทางโอนเงินจากโปรตุเกสต้องการหลักฐานว่าลูกค้า +239 สมัครจนเสร็จได้ การรัน QA ด้วยหมายเลขจริงของเกาะตอบคำถามนี้ได้เร็วกว่าตั๋วซัพพอร์ตจากผู้ใช้ที่สับสน

หมายเลข +239 เขียนและจัดเก็บอย่างไร

หมายเลขในประเทศมีเจ็ดหลัก และหมายเลขมือถือมักขึ้นต้นด้วย 9 ในรูปแบบ E.164 จะเป็น +239 ตามด้วยเจ็ดหลัก หมายเลขสั้นแบบนี้ทำให้ตัวตรวจสอบที่คาดหวังความยาวขั้นต่ำแปดหลักขึ้นไปสะดุด จึงควรเพิ่มเคส +239 ในเทสต์การพาร์ส และทำให้ช่องว่างหรือขีดกลางเป็นมาตรฐานก่อนเก็บค่า

นิสัยเล็กๆ ไม่กี่ข้อช่วยให้ข้อมูลสะอาด

เก็บสตริง +239 แบบมาตรฐาน และเก็บประเทศที่ตรวจพบไว้ในคอลัมน์แยก
ตัดคำนำหน้าสากล 00239 ที่ผู้ใช้วางมาจากรายชื่อผู้ติดต่อเก่า
อย่าเติมหมายเลขเจ็ดหลักให้ยาวขึ้นเพื่อให้พอดีกับฟิลด์ฐานข้อมูลความยาวคงที่ ให้ขยายฟิลด์แทน
ใส่ fixture +239 อย่างน้อยหนึ่งรายการในยูนิตเทสต์ เพื่อไม่ให้การเปลี่ยนตัวตรวจสอบในอนาคตทำให้มันเสียโดยไม่มีใครรู้

OTP Gateway มีอะไรให้สำหรับเซาตูเมและปรินซิปี

แค็ตตาล็อกสดของประเทศนี้มีมากกว่า 600 บริการ ตัวเลือกยอดนิยมได้แก่ WhatsApp, Telegram, Facebook, Instagram, Google (Gmail & YouTube), Microsoft & Outlook, Discord, LinkedIn, Signal, Viber, imo และ Amazon

ในตลาดขนาดเล็ก ความครอบคลุมอาจบางลงในบางช่วงเวลา ให้อ่าน GET /api/v1/prices ก่อนสั่งซื้อทุกครั้งแทนที่จะเชื่อผลของเมื่อวาน และหากเส้นทางว่าง ให้เปรียบเทียบกับเส้นทางลูโซโฟนใกล้เคียงอย่าง กาบูเวร์ดี หรือเส้นทางที่ใหญ่กว่าอย่าง แองโกลา

โฟลว์ API สำหรับ country id st เป็นอย่างไร

GET /api/v1/prices?country=st&service=<id> ส่งคืนราคาสดและความพร้อมใช้งาน
POST /api/v1/activations พร้อม {"service": "<id>", "country": "st"} จองหมายเลข
ใช้หมายเลขในแอปของคุณ แล้วรอ activation.sms_received บน webhook หรือโพลล์ GET /api/v1/activations/{id}
POST /api/v1/activations/{id}/cancel ยุติความพยายามที่คุณไม่ต้องการแล้ว

การเรียกทั้งหมดไปที่ https://otproute.com/api/v1 พร้อม Bearer key or_live_ ตรวจสอบ X-OTPRoute-Signature (HMAC-SHA256 ของ "<t>.<raw body>") และทิ้ง timestamp ที่เก่า การรักษาความปลอดภัย webhook ของ OTP ด้วย HMAC แสดงวิธีทำ

คนที่เข้าถึงโค้ดไม่ได้ใช้งานได้หรือไม่

ได้ หลังจากลงทะเบียนด้วยรหัสทางอีเมลหรือ Google ให้เปิด OTP Gateway เลือกบริการ เลือกเซาตูเมและปรินซิปี แล้วยืนยันราคาสด หมายเลขจะปรากฏทันที และรหัสจะแสดงบนหน้าจอเดียวกันเมื่อ SMS มาถึง

วิธีนี้เหมาะกับเจ้าหน้าที่ซัพพอร์ตที่ต้องจำลองข้อร้องเรียนของลูกค้าจากหมู่เกาะ หรือผู้จัดการผลิตภัณฑ์ที่อยากดูหน้าจอออนบอร์ดภาษาโปรตุเกสสักครั้งก่อนปล่อย ควรเปิด TOTP แบบสองขั้นตอนให้กับบัญชี เพราะแดชบอร์ดเก็บทั้งกระเป๋าเงินและรหัสที่ได้รับ

แล้วหมายเลขระยะยาว การเรียกเก็บเงิน และ sandbox ล่ะ

ไม่มีหมายเลข +239 ระยะยาวแบบบริการตนเอง Dedicated Virtual Numbers เป็นผลิตภัณฑ์ของสหรัฐอเมริกาและแคนาดา เริ่มต้นที่ $1.95/เดือน หากต้องการสายประจำบนเกาะ ให้ส่งอีเมลถึง [email protected] โดยทราบว่ากฎท้องถิ่นเป็นตัวกำหนดว่าทำได้หรือไม่

คุณชำระจากกระเป๋าเงิน USD แบบเติมเงินล่วงหน้าเพียงใบเดียว ไม่มีค่าธรรมเนียมรายเดือน เติมด้วยบัตรหรือ USDT/USDC พร้อมใบแจ้งหนี้ PDF ทุกครั้งที่เติมเงิน บัญชี sandbox ส่งคืนหมายเลขและรหัสจำลองสำหรับการทดสอบการเชื่อมต่อ รายละเอียดอยู่ที่ /pricing

เนื่องจากกระเป๋าเงินใช้ร่วมกันทุกประเทศ ทีมที่ทดสอบหมู่เกาะควบคู่กับโปรตุเกสหรือบราซิลจะเห็น activation ทั้งหมดบนยอดคงเหลือเดียวและชุดใบแจ้งหนี้เดียว ทำให้การกระทบยอดตอนสิ้นเดือนของฝ่ายการเงินง่ายขึ้น

คำถามที่พบบ่อย

ฉันตรวจการสมัครในเซาตูเมและปรินซิปีของแอปโดยไม่ต้องไปที่หมู่เกาะได้หรือไม่

ได้ สั่งหมายเลข +239 จาก OTP Gateway ของ OTP Route ใส่ในแอปของคุณ แล้วอ่านรหัสในแดชบอร์ดหรือผ่าน API

ถ้ารหัส +239 ไม่มาต้องทำอย่างไร

ให้ activation ได้เวลาเต็ม 20 นาที แล้วลองใหม่ภายหลังหรือใช้เส้นทางบริการอื่น หลีกเลี่ยงการสั่งซื้อซ้ำภายในไม่กี่วินาที

activation ของเซาตูเมและปรินซิปีที่ล้มเหลวคิดเงินหรือไม่

ไม่ หาก SMS ไม่มาก่อนหมดเวลา หรือคุณยกเลิก จำนวนเงินทั้งหมดจะถูกคืนเข้ากระเป๋าเงินของคุณ

ทำไมแอปจึงปฏิเสธหมายเลขยืนยันเซาตูเมและปรินซิปีของฉัน

บางบริการปฏิเสธหมายเลขเสมือน ซึ่งอยู่นอกเหนือการควบคุมของ OTP Route และเป็นเหตุผลที่ activation ที่ไม่ได้ใช้จะได้รับเงินคืน

ข้อความยืนยันจะเป็นภาษาโปรตุเกสหรือไม่

มักเป็น เพราะภาษาโปรตุเกสเป็นภาษาราชการ แต่แต่ละแอปเลือกถ้อยคำของตนเองและอาจใช้ภาษาอังกฤษ

API OTP ของเซาตูเมและปรินซิปีมีการจำกัดอัตราหรือไม่

แต่ละบัญชีเรียกได้ 300 คำขอต่อนาที และมีได้สูงสุด 10 API key กับ 5 webhook endpoint

รันใน CI job ได้หรือไม่

ได้ โดยสั่ง activation หนึ่งรายการต่อการรันหนึ่งครั้ง หน้าการทดสอบ QAอธิบายวิธีที่ทีมต่างๆ จัดโครงสร้าง

OTP Route อนุญาตให้ใช้งานแบบใดบ้าง

การทดสอบผลิตภัณฑ์ของคุณเองและการดำเนินงานบัญชีธุรกิจที่ถูกต้องตามกฎหมาย ภายใต้ข้อกำหนดของแต่ละบริการและนโยบายการใช้งานที่ยอมรับได้ของ OTP Route

ชื่อบริการเป็นเครื่องหมายการค้าของเจ้าของนั้น ๆ OTP Route ไม่มีความเกี่ยวข้องกับบริการเหล่านั้น โปรดใช้หมายเลขอย่างถูกกฎหมาย และปฏิบัติตามข้อกำหนดของแต่ละบริการและนโยบายการใช้งานที่ยอมรับได้ของเรา

รับรหัสยืนยัน +239 จากเซาตูเมและปรินซิปี