Quickstart
Send your first verification code and check it in five minutes, without sending a real message.
OTP.ps sends one-time verification codes by text message to Palestinian mobile numbers on Jawwal (059) and Ooredoo (056), in Arabic or English, starting with your business's name. Your server makes two calls: one to send a code, one to check what the customer typed.
1. Get a test key
Create an account. You get a test key (otp_test_…) straight away, on the dashboard's API keys page. Test keys never send a message and never cost anything, and they work before your account is approved.
Keep the key in an environment variable on your server:
OTP_PS_API_KEY=otp_test_your_key_here2. Send a code
0599000001 is a sandbox number: with a test key, its code is always 1234.
curl https://otp.ps/api/v1/verify/send \
-H "Authorization: Bearer $OTP_PS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"phone": "0599000001", "purpose": "verify", "locale": "ar"}'{
"id": "ver_9f2KxQe1Lm0aBcDe",
"status": "pending",
"to": "0599 ••• 001",
"network": "jawwal",
"purpose": "verify",
"locale": "ar",
"segments": 0,
"attempts": 0,
"test": true,
"created_at": "2026-11-19T10:00:00.000Z",
"expires_at": "2026-11-19T10:05:00.000Z",
"verified_at": null,
"test_code": "1234"
}Keep the id on your server (in the session or on the order). With a live key, the customer receives:
متجر نور: رمز التحقق 4821، صالح 5 دقائق، لا تشاركه.
3. Check the code
curl https://otp.ps/api/v1/verify/check \
-H "Authorization: Bearer $OTP_PS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"id": "ver_9f2KxQe1Lm0aBcDe", "code": "1234"}'{ "valid": true, "attempts_left": 0, "status": "approved", "id": "ver_9f2KxQe1Lm0aBcDe", "…": "…" }Trust only valid: true. It is true once, on the check that approved the code.
4. Go live
When your integration works in the sandbox, OTP.ps approves your account and you top up your balance. Then create a live key (otp_live_…), put it in the same environment variable, and go through the production checklist.
Next
- Verification lifecycle: statuses, expiry, tries, resending.
- Sandbox: test numbers that simulate every outcome.
- Examples: Node.js, Next.js, PHP, Laravel, Python, WooCommerce.
- API reference and the OpenAPI document.