دليل مطوري وتين بلس

{ "reference_ids": ["ORD-1", "ORD-2"] }

<?php
$url = "https://wateenplus.com/api/v1/telecom/recharge";
$username = "WTN-XXXXXX";
$apiKey = "pk_live_xxxx";
$apiSecret = "sk_live_xxxx";

// 1. تحضير بيانات الطلب بدقة (مثال شحن اتصالات)
$payload = json_encode([
    "service_id" => 15,
    "reference_id" => "REQ-" . time(),
    "phone" => "770000000",
    "expected_price" => 1000, // إجباري لحماية أموالك من تغير السعر بالموقع
    "gateway" => "north"  // يتم هنا إضافة هامش بوابة الشمال تلقائياً
]);

// 2. جلب الوقت وتوليد التوقيع ومفتاح التكرار
$timestamp = time();
$stringToSign = $timestamp . '.' . $payload;
$signature = hash_hmac('sha256', $stringToSign, $apiSecret);
$idempotencyKey = bin2hex(random_bytes(16)); // مفتاح فريد

// 3. إرسال الطلب مع الترويسات الأمنية
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "X-WTN-Username: " . $username,
    "X-WTN-ApiKey: " . $apiKey,
    "X-WTN-Timestamp: " . $timestamp,
    "X-WTN-Signature: " . $signature,
    "Idempotency-Key: " . $idempotencyKey,
    "Content-Type: application/json",
    "Accept: application/json"
]);

$response = curl_exec($ch);
curl_close($ch);

echo $response;
?>

const axios = require('axios');
const crypto = require('crypto');

async function placeOrder() {
  const url = 'https://wateenplus.com/api/v1/telecom/recharge';
  const username = 'WTN-XXXXXX';
  const apiKey = 'pk_live_xxxx';
  const apiSecret = 'sk_live_xxxx';

  // 1. تحضير البيانات كنص JSON
  const payload = JSON.stringify({
    service_id: 15,
    reference_id: 'REQ-' + Date.now(),
    phone: '770000000',
    expected_price: 1000,
    gateway: 'north'
  });

  // 2. توليد الوقت والتوقيع ومفتاح التكرار
  const timestamp = Math.floor(Date.now() / 1000).toString();
  const stringToSign = timestamp + '.' + payload;
  const signature = crypto.createHmac('sha256', apiSecret).update(stringToSign).digest('hex');
  const idempotencyKey = crypto.randomUUID();

  try {
    const response = await axios.post(url, payload, {
      headers: {
        'X-WTN-Username': username,
        'X-WTN-ApiKey': apiKey,
        'X-WTN-Timestamp': timestamp,
        'X-WTN-Signature': signature,
        'Idempotency-Key': idempotencyKey,
        'Content-Type': 'application/json'
      }
    });
    console.log("Success:", response.data);
  } catch (error) {
    console.error("Error:", error.response ? error.response.data : error.message);
  }
}

placeOrder();

import requests
import time
import hmac
import hashlib
import json
import uuid

url = "https://wateenplus.com/api/v1/telecom/recharge"
username = "WTN-XXXXXX"
api_key = "pk_live_xxxx"
api_secret = "sk_live_xxxx"

# 1. تحضير البيانات
payload_dict = {
    "service_id": 15,
    "reference_id": f"REQ-{int(time.time())}",
    "phone": "770000000",
    "expected_price": 1000,
    "gateway": "north"
}
payload = json.dumps(payload_dict, separators=(',', ':'))

# 2. توليد الوقت والتوقيع ومفتاح التكرار
timestamp = str(int(time.time()))
string_to_sign = f"{timestamp}.{payload}"
signature = hmac.new(api_secret.encode(), string_to_sign.encode(), hashlib.sha256).hexdigest()
idempotency_key = str(uuid.uuid4())

# 3. إرسال الطلب
headers = {
    "X-WTN-Username": username,
    "X-WTN-ApiKey": api_key,
    "X-WTN-Timestamp": timestamp,
    "X-WTN-Signature": signature,
    "Idempotency-Key": idempotency_key,
    "Content-Type": "application/json",
    "Accept": "application/json"
}

response = requests.post(url, data=payload, headers=headers)

if response.status_code == 200:
    print("Success:", response.json())
else:
    print("Error:", response.text)