ทดสอบการสมัครด้วยเบอร์ +226: เช็กลิสต์เบอร์ยืนยันตัวตนบูร์กินาฟาโซ

ควรเตรียมอะไรให้พร้อมก่อนขอเบอร์ +226?

ความล้มเหลวในความพยายามครั้งแรกส่วนใหญ่มาจากการตั้งค่าที่ขาดไป ไม่ใช่ปัญหาของเส้นทางเอง ลองไล่ตรวจรายการเหล่านี้ก่อนสั่งซื้อครั้งแรก

• API key สร้างได้ใน Developer console โดยคีย์ใช้งานจริงจะขึ้นต้นด้วย or_live_ และส่งเป็น Bearer token คุณถือคีย์ได้สูงสุด 10 ชุด จึงควรแยกคีย์สำหรับ staging และ CI ออกจากกัน
• กระเป๋าเงินที่เติมเงินแล้ว เติมด้วยบัตรหรือ USDT/USDC ก็ได้ ระบบจะไม่หักเงินสำหรับรหัสที่ไม่เคยมาถึง
• id ที่ถูกต้อง บูร์กินาฟาโซคือ bf ใน API ให้ค้นหา id ของบริการด้วย GET /api/v1/services แทนการเดา
• แผนการรับข้อมูล จะใช้ webhook endpoint พร้อมเก็บ secret ไว้อย่างปลอดภัย หรือใช้ลูป polling ที่เว้นระยะเหมาะสมก็ได้ บัญชีหนึ่งลงทะเบียน webhook endpoint ได้สูงสุด 5 รายการ ซึ่งสะดวกสำหรับแยก staging ออกจาก production
• บัญชีที่ถูกต้องตามกฎหมายสำหรับยืนยัน เช่น ผู้ใช้ทดสอบบนผลิตภัณฑ์ของคุณเอง หรือบัญชีธุรกิจที่ทีมคุณดูแล ต้องเป็นไปตามข้อกำหนดของแต่ละบริการและนโยบายการใช้งานที่ยอมรับได้ (Acceptable Use Policy) ของ OTP Route

เอกสารอ้างอิง API แสดงทุกฟิลด์ หากต้องการอ่านก่อนเริ่มเขียนโค้ด

แอปใดบ้างที่ส่งรหัสมายังเส้นทางบูร์กินาฟาโซได้?

แคตตาล็อกสดของ bf ในขณะนี้มีบริการมากกว่า 900 รายการ บริการยอดนิยมที่พร้อมใช้งาน ณ เวลาที่เขียนบทความนี้ ได้แก่ WhatsApp, Facebook, Instagram, TikTok, Telegram, Google (Gmail & YouTube), Microsoft & Outlook, imo, Viber, Signal, LinkedIn, Uber, Amazon และ ChatGPT (OpenAI)

ความพร้อมใช้งานเปลี่ยนแปลงตลอดวัน เพราะพาร์ตเนอร์ผู้ให้บริการเครือข่ายของเราเพิ่มและลดกำลังรองรับอยู่เสมอ ดังนั้นให้ถือว่ารายการข้างต้นเป็นภาพรวม ณ ช่วงเวลาหนึ่ง โค้ดของคุณควรเรียก GET /api/v1/prices ก่อนสั่งซื้อทุกครั้ง ซึ่งจะตอบกลับด้วยราคาปัจจุบันและบอกว่าคู่บริการกับประเทศนั้นสั่งซื้อได้หรือไม่

ลำดับการเรียก API สำหรับประเทศ `bf` เป็นอย่างไร?

1. อ่านราคาของคู่บริการที่ต้องการด้วย GET /api/v1/prices?country=bf&service=whatsapp (เปลี่ยนเป็น id บริการของคุณเอง)
2. สร้าง activation ด้วย POST /api/v1/activations โดยใช้ body {"service": "whatsapp", "country": "bf"} เก็บ activation id ที่ได้กลับมาไว้ เพราะทุกขั้นตอนถัดไปอ้างอิงด้วย id นี้
3. สั่งให้แอปที่คุณกำลังทดสอบส่ง SMS โดยใช้เบอร์ +226 จากผลลัพธ์ที่ได้
4. รอรับ activation.sms_received บน webhook ของคุณ ตรวจสอบเฮดเดอร์ X-OTPRoute-Signature ซึ่งมีรูปแบบ t=<unix>,v1=<hex> โดยคำนวณ HMAC-SHA256 ของ "<t>.<raw body>" ด้วย secret ของ endpoint แล้วเปรียบเทียบ และทิ้งคำขอที่ timestamp เก่าเกินไป บทความ การรักษาความปลอดภัย webhook ของ OTP ด้วย HMAC ครอบคลุมกรณีขอบต่าง ๆ ไว้แล้ว
5. ไม่ได้ใช้ webhook? ให้ poll GET /api/v1/activations/{id} ทุกไม่กี่วินาทีแทน
6. เสร็จก่อนเวลา หรือกำลังทดสอบเส้นทางกรณีล้มเหลว? เรียก POST /api/v1/activations/{id}/cancel นอกจากนี้คุณจะเห็น activation.expired หรือ activation.cancelled เมื่อรอบการทำงานจบลงโดยไม่มีรหัส

บัญชีรองรับ 300 คำขอต่อนาที ซึ่งเพียงพอสำหรับการ polling หากแต่ละรอบเว้นระยะถอยเล็กน้อย

คนที่ไม่เขียนโค้ดสั่งรหัส +226 ได้ไหม?

ได้ พนักงานซัพพอร์ต ฝ่ายการตลาด และผู้จัดการบัญชีสามารถทำแบบเดียวกันด้วยมือได้ เพียงลงชื่อเข้าใช้ เปิด OTP Gateway เลือกบูร์กินาฟาโซ เลือกบริการ แล้วยืนยันราคาที่แสดงบนหน้าจอ เบอร์จะปรากฏขึ้นทันที นำไปวางในแอป ขอ SMS แล้วรหัสจะเข้ามาที่แถวเดียวกันในแดชบอร์ด จะเปิดแท็บค้างไว้หรือกลับมาดูภายหลังก็ได้ เพราะ activation จะคอยรับรหัสไปตลอด 20 นาทีเต็ม

ควรเก็บเบอร์ +226 อย่างไร และ SMS จะใช้ภาษาอะไร?

บูร์กินาฟาโซใช้เบอร์ระดับประเทศ 8 หลักและไม่มีรหัสนำหน้าภายในประเทศ (trunk prefix) จึงไม่มีเลขศูนย์นำหน้าให้ตัดออก รูปแบบเบอร์ในประเทศก็คือตัวเลขที่ตามหลัง +226 นั่นเอง ให้เก็บเบอร์ในรูปแบบ E.164 เป็น +226 ตามด้วยเลข 8 หลักนั้น และทำให้ข้อมูลที่ผู้ใช้กรอกเป็นมาตรฐานก่อนบันทึก โดยลบช่องว่าง เครื่องหมายขีด และ 00 สากลออก กฎตรวจสอบที่คัดลอกมาจากตลาดที่ใช้เลขศูนย์นำหน้าจะปฏิเสธเบอร์ +226 ที่ถูกต้อง ซึ่งเป็นบั๊กด้าน localization แบบคลาสสิกที่ควรมี regression test รองรับ

ภาษาฝรั่งเศสเป็นภาษาของงานราชการ การศึกษา และธุรกิจมายาวนาน ส่วนภาษามอเร (Mooré) ดิวลา (Dioula) และฟูลเฟลเด (Fulfulde) ก็มีผู้พูดอย่างกว้างขวาง เทมเพลตข้อความยืนยันส่วนใหญ่จะมาเป็นภาษาฝรั่งเศสหรืออังกฤษ ขึ้นอยู่กับ locale ของบัญชี จึงควรให้ตัวแยกวิเคราะห์ของคุณรองรับตัวอักษรที่มีเครื่องหมายกำกับรอบ ๆ ตัวเลข

ทีมมักทดสอบในตลาดนี้เมื่อเปิดตัวในแอฟริกาตะวันตกที่ใช้ภาษาฝรั่งเศส ตรวจข้อความภาษาฝรั่งเศสบนหน้าสมัครสมาชิก หรือเริ่มรับลูกค้าสำหรับผลิตภัณฑ์ชำระเงินและ mobile money หน้า การเริ่มใช้งานด้านฟินเทค อธิบายรูปแบบนี้ไว้

ควรลองทำอย่างไรเมื่อไม่มีรหัสเข้ามาที่เบอร์?

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

คู่มือ การลดความล้มเหลวในการส่ง OTP อธิบายการออกแบบการลองซ้ำไว้ลึกกว่านี้

มีเบอร์บูร์กินาฟาโซแบบระยะยาวไหม และการเรียกเก็บเงินเป็นอย่างไร?

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

ค่าใช้จ่ายของ activation +226 จะถูกหักจากกระเป๋าเงิน USD แบบเติมเงินล่วงหน้าเพียงใบเดียว ไม่มีค่าสมัครสมาชิกและไม่ต้องเลือกแพ็กเกจ การเติมเงินด้วยบัตรหรือ USDT/USDC จะได้รับใบแจ้งหนี้ PDF ทางอีเมลทุกครั้ง สำหรับงานเชื่อมต่อระบบ คุณสามารถขอให้เปลี่ยนบัญชีพัฒนาเป็นโหมด sandbox ซึ่งจะคืนเบอร์และรหัสจำลอง เพื่อให้ชุดทดสอบของคุณไม่แตะเงินจริง ดูอัตราปัจจุบันได้ที่หน้าราคา

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

ฉันทดสอบขั้นตอนสมัครสมาชิกของแอปในบูร์กินาฟาโซโดยไม่มีซิมในพื้นที่ได้ไหม?

ได้ สั่งเบอร์ +226 บน OTP Gateway สั่งให้แอปของคุณส่ง SMS แล้วอ่านรหัสในแดชบอร์ดหรือผ่าน API คุณจ่ายเงินก็ต่อเมื่อรหัสมาถึงเท่านั้น

country id ของบูร์กินาฟาโซใน API ของ OTP Route คืออะไร?

คือ bf ใช้คู่กับ id บริการจาก GET /api/v1/services เมื่อเรียก endpoint ราคาหรือ activations

เบอร์ +226 ขึ้นต้นด้วยศูนย์หรือไม่?

ไม่ บูร์กินาฟาโซไม่มี trunk prefix เบอร์จึงเป็นเพียง +226 ตามด้วยเลข 8 หลักในรูปแบบ E.164

เบอร์ยืนยันตัวตนของบูร์กินาฟาโซใช้งานได้นานเท่าใด?

20 นาทีต่อหนึ่ง activation หากหมดเวลาโดยไม่มี SMS หรือคุณยกเลิก ยอดเต็มจะคืนเข้ากระเป๋าเงินของคุณโดยอัตโนมัติ

รหัสจะมาเป็นภาษาฝรั่งเศสไหม?

ขึ้นอยู่กับบริการที่ส่งและภาษาที่ตั้งไว้ในบัญชี กรณีที่พบบ่อยคือฝรั่งเศสและอังกฤษ จึงควรทดสอบทั้งสองภาษาหากผลิตภัณฑ์ของคุณรองรับ

ใช้เบอร์ +226 เปิดหลายบัญชีบนแพลตฟอร์มเดียวได้ไหม?

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

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