รับรหัสยืนยัน +966 ด้วยโปรแกรมสำหรับการเปิดตัวในซาอุดีอาระเบีย

activation +966 หนึ่งรายการผ่าน API มีลักษณะอย่างไร

เริ่มจากการเรียกใช้งาน เพราะผู้อ่านหน้านี้ส่วนใหญ่กำลังเชื่อม API ยืนยันทาง SMS เข้ากับชุดทดสอบหรือเครื่องมือภายใน endpoint ทั้งหมดอยู่ใต้ https://otproute.com/api/v1 และต้องใช้ Bearer key ที่ขึ้นต้นด้วย or_live_ ซึ่งสร้างใน Developer console

1. GET /api/v1/countries และ GET /api/v1/services ให้ id ซาอุดีอาระเบียคือ sa
2. GET /api/v1/prices?country=sa&service=<id> ส่งคืนอัตราสดของคู่นั้น ให้บันทึกไว้ข้างผลการรัน
3. POST /api/v1/activations พร้อม {"service": "<id>", "country": "sa"} ส่งคืน activation id และหมายเลข +966
4. เทสต์ของคุณกรอกหมายเลขในแอป แล้วรหัสจะมาเป็นอีเวนต์หรือผ่าน GET /api/v1/activations/{id}
5. หากเทสต์ถูกยกเลิกกลางคัน POST /api/v1/activations/{id}/cancel จะปล่อยหมายเลขและคืนเงินเข้ากระเป๋าเงิน

GET /api/v1/balance มีประโยชน์เป็นการตรวจก่อนเริ่ม เพื่อให้งานรายคืนล้มเหลวตั้งแต่ต้นพร้อมข้อความที่ชัดเจน แทนที่จะล้มกลางทาง ขีดจำกัดที่ควรวางแผน ได้แก่ 10 key และ 5 webhook endpoint ต่อบัญชี และ 300 คำขอต่อนาที

ตัวรับ webhook ของเราควรจัดการอีเวนต์ OTP ของซาอุดีอาระเบียอย่างไร

ลงทะเบียน endpoint แล้วสมัครรับ activation.sms_received, activation.expired และ activation.cancelled ทุกคำขอมี X-OTPRoute-Signature ในรูปแบบ t=<unix>,v1=<hex>

• สร้างสตริงที่ลงลายเซ็นขึ้นใหม่เป็น <t>.<raw body> แล้วคำนวณ HMAC-SHA256 ด้วยความลับของ endpoint นั้น
• เปรียบเทียบกับ v1 ด้วยฟังก์ชันที่ใช้เวลาคงที่ และปฏิเสธทุกอย่างที่ timestamp เก่าเกินไป
• ถือว่าแต่ละอีเวนต์ผูกกับ activation id เพื่อให้การส่งซ้ำไม่อัปเดตสองครั้ง
• ตอบกลับ 2xx อย่างรวดเร็ว และทำงานที่ช้าในงานเบื้องหลัง

การโพลล์ยังเป็นทางสำรองที่ใช้ได้สำหรับ runner ที่รับการเชื่อมต่อขาเข้าไม่ได้ บทความของเรา การดักจับ OTP ด้วย webhook และ การรักษาความปลอดภัย webhook ของ OTP ด้วย HMAC อธิบายเพิ่มเติม

ทำไมทีมผลิตภัณฑ์จึงทดสอบด้วยหมายเลข +966

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

บริการใดบ้างที่รับรหัสบนเส้นทางซาอุดีอาระเบียได้

สแนปช็อตสดของซาอุดีอาระเบียครอบคลุมมากกว่า 1,000 บริการ ที่ใช้บ่อยได้แก่ Snapchat, WhatsApp, X (Twitter), Uber, TikTok, Instagram, Google (Gmail & YouTube), Telegram, Amazon, Microsoft & Outlook, LinkedIn, Discord และ Netflix Snapchat และ X มีผู้ใช้จำนวนมากในราชอาณาจักร จึงมักเป็นรายการในเช็กลิสต์การปรับให้เข้ากับท้องถิ่น สต็อกเปลี่ยนไปตลอดวัน ดังนั้นให้เรียก API ตอนรัน

ฉันจะจัดรูปแบบหมายเลข +966 และพาร์สข้อความภาษาอาหรับอย่างไร

ในประเทศ หมายเลขมือถือซาอุฯ เขียนพร้อมเลขศูนย์นำหน้า (trunk 0) โดยทั่วไปเป็น 05 ตามด้วยแปดหลัก รูปแบบสากลตัดเลขศูนย์นั้นออก คือ +966 5 ตามด้วยแปดหลักที่เหลือ ให้ทำทุกอย่างเป็น E.164 ตั้งแต่จุดที่รับข้อมูล และตัดเลขศูนย์ออกหากผู้ใช้พิมพ์ต่อจากรหัสประเทศ

ภาษาอาหรับเป็นภาษาราชการ ข้อความยืนยันจึงอาจมาเป็นภาษาอาหรับ ภาษาอังกฤษ หรือทั้งสองอย่าง ภาษาอาหรับเขียนจากขวาไปซ้าย และบางเทมเพลตอาจใช้ตัวเลขอารบิก-อินเดียแทนตัวเลขตะวันตก ตัวพาร์สที่แปลงตัวเลขเหล่านั้นเป็น ASCII ก่อนจับคู่ และบันทึก UTF-8 ดิบ จะหลีกเลี่ยงความล้มเหลวหลอกที่น่าหงุดหงิดได้

มีเส้นทางแดชบอร์ดสำหรับคนที่เขียนโค้ดไม่เป็นหรือไม่

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

ถ้ารหัสไม่มาล่ะ แล้วสายระยะยาวและการเรียกเก็บเงินเป็นอย่างไร

หากไม่มี SMS มาถึงภายใน 20 นาที หรือคุณยกเลิก จำนวนเงินทั้งหมดจะกลับเข้ากระเป๋าเงินโดยอัตโนมัติ ให้รอจนหน้าต่างเวลาจบ ลองใหม่ภายหลังหรือผ่านเส้นทางบริการอื่น ตรวจสอบว่าบริการรับหมายเลขเสมือนหรือไม่ และหลีกเลี่ยงการสั่งซื้อซ้ำถี่ๆ

ไม่มีหมายเลขซาอุฯ ระยะยาวแบบบริการตนเอง Dedicated Virtual Numbers มีเฉพาะสหรัฐอเมริกาและแคนาดา เริ่มต้นที่ $1.95/เดือน หากต้องการสาย +966 ระยะยาว ให้ส่งอีเมลถึง [email protected] โดยโปรดทราบว่ากฎท้องถิ่นเป็นตัวกำหนดว่าทำได้หรือไม่

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

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

ฉันรับ SMS OTP ของซาอุฯ ผ่าน API ได้อย่างไร

สร้าง activation ด้วย country sa และ service id ของคุณ จากนั้นนำรหัสจาก webhook activation.sms_received หรือโดยการโพลล์ activation

หมายเลข +966 สำหรับทดสอบถูกเรียกเก็บเงินหรือไม่หากรหัสล้มเหลว

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

ฉันทดสอบโฟลว์การสมัครของแอปในซาอุฯ โดยไม่มีซิมในพื้นที่ได้หรือไม่

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

ฉันควรเก็บหมายเลขมือถือซาอุฯ ที่กรอกเป็น 05XXXXXXXX อย่างไร

ตัดเลขศูนย์นำหน้าออก แล้วเก็บเป็น +966 5 ตามด้วยแปดหลักที่เหลือในรูปแบบ E.164

เราเก็บหมายเลขซาอุฯ เดิมไว้สำหรับการล็อกอินครั้งต่อไปได้หรือไม่

ไม่ได้กับผลิตภัณฑ์แบบบริการตนเอง เพราะ Dedicated Numbers ระยะยาวครอบคลุมเฉพาะสหรัฐอเมริกาและแคนาดา หากต้องการสายซาอุฯ ให้ส่งอีเมลถึงทีมงาน โดยไม่มีการรับประกันว่าจะจัดให้ได้

มีวิธีซ้อมโฟลว์ของซาอุฯ ก่อนที่จะใช้เงินจริงหรือไม่

มี ขอโหมด sandbox สำหรับบัญชีพัฒนาเพื่อรับหมายเลขและรหัสจำลอง รวมถึง webhook

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

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

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