واجهة non-voip للتجار v1

الرابط الأساسي والمصادقة

البدء السريع

1. أنشئ مفتاح Merchant API من لوحة API واحتفظ به على خادمك. يتطلب إنشاء المفتاح وتدويره واستخدامه اشتراكاً نشطاً في فئة merchant.
2. أرسل X-Api-Key مع كل طلب.
3. اقرأ الكتالوج، ثم أنشئ عملية تحقق باستخدام productServiceId ومفتاح Idempotency-Key فريد.
4. استعلم عن عملية التحقق حتى تحتوي data.messages على رمز. عمليات الرسالة الواحدة تنتقل عادةً إلى completed وليس otp_received.

export NV_API_KEY='nvr_live_...'
API='https://non-voip-api.0246864.xyz/api/v1'

PRODUCT_SERVICE_ID=$(curl --fail-with-body --silent --show-error   "$API/catalog?test=true"   -H "X-Api-Key: $NV_API_KEY" | jq -r '.data[0].productServiceId')

VERIFICATION_ID=$(curl --fail-with-body --silent --show-error   -X POST "$API/verifications?test=true"   -H "X-Api-Key: $NV_API_KEY"   -H "Idempotency-Key: $(uuidgen)"   -H "Content-Type: application/json"   -d "{"productServiceId":"$PRODUCT_SERVICE_ID"}" | jq -r '.data.verificationId')

for _ in $(seq 20); do
  curl --fail-with-body --silent --show-error --max-time 15     "$API/verifications/$VERIFICATION_ID?test=true"     -H "X-Api-Key: $NV_API_KEY" | jq -e '.data.messages[0].code' && break
  sleep 5
done

أساسيات التكامل في الإنتاج

وضع الاختبار (بدون خصم حقيقي)

أضف ?test=true للحصول على بيانات حتمية بنفس شكل الإنتاج دون استدعاء المزود أو خصم الرصيد. تبقى المصادقة والتسجيل وحدود الطلبات مطبقة.

إشعارات Webhook

مثال على الحمولة

{
  "event": "verification.completed",
  "timestamp": "2026-08-27T10:00:00.000Z",
  "balance": 124.5,
  "data": {
    "subscriptionId": "550e8400-e29b-41d4-a716-446655440000",
    "phoneNumber": "+15550001234",
    "otpCode": "483920",
    "messages": [
      {
        "code": "483920",
        "message": "Your verification code is 483920",
        "receivedAt": "2026-08-27T09:59:58.000Z"
      }
    ],
    "status": "completed",
    "productServiceId": "0f1a5a6c-1c2d-4f2b-9a1e-3c9d4b7e2f10"
  }
}

التاجر - الرصيد

التاجر - الكتالوج

التاجر - عمليات التحقق

موارد