مكتبات SDK — حزم جاهزة لأشهر لغات البرمجة.

import os, uuid, wthaiq

wt = wthaiq.Client(os.environ['WTHAIQ_API_KEY'])

sr = wt.signature_requests.create(
    title='عقد عمل — أحمد م.',
    source={'type': 'template', 'template_id': 'tpl_employment'},
    legal_level='aes',
    ordered=True,
    signers=[{
        'name': 'أحمد محمد',
        'email': 'ahmed@example.com',
        'type': 'individual',
        'method': 'draw',
        'require_identity': True,
        'fields': {'job_title': 'مهندس برمجيات', 'salary': '25000'},
    }],
    reminders={'enabled': True, 'interval_hours': 48, 'max': 3},
    metadata={'order_id': 'A-1024'},
    idempotency_key=str(uuid.uuid4()),
)

print(sr.id, sr.status)  # sr_3n8Kd2Qa1V sent

# auto_paging_iter يتنقّل عبر كل الصفحات تلقائيًا
for sr in wt.signature_requests.list(status='completed', limit=100).auto_paging_iter():
    print(sr.id, sr.reference)

import os, wthaiq
from flask import Flask, request

app = Flask(__name__)
endpoint_secret = os.environ['WTHAIQ_WEBHOOK_SECRET']

@app.post('/hooks/wthaiq')
def handle():
    payload = request.get_data()
    sig = request.headers.get('Wthaiq-Signature')
    try:
        event = wthaiq.Webhook.construct_event(payload, sig, endpoint_secret)
    except wthaiq.error.SignatureVerificationError:
        return 'invalid signature', 400
    if event.type == 'signature_request.completed':
        sr = event.data.object  # كائن signature_request
        # فعّل الحساب أو خزّن الوثيقة الموقّعة
    return {'received': True}

require 'vendor/autoload.php';

$wt = new \Wthaiq\Client(getenv('WTHAIQ_API_KEY'));

$sr = $wt->signatureRequests->create([
  'title' => 'عقد عمل — أحمد م.',
  'source' => ['type' => 'template', 'template_id' => 'tpl_employment'],
  'legal_level' => 'aes',
  'ordered' => true,
  'signers' => [[
    'name' => 'أحمد محمد',
    'email' => 'ahmed@example.com',
    'type' => 'individual',
    'method' => 'draw',
    'require_identity' => true,
    'fields' => ['job_title' => 'مهندس برمجيات', 'salary' => '25000'],
  ]],
  'reminders' => ['enabled' => true, 'interval_hours' => 48, 'max' => 3],
  'metadata' => ['order_id' => 'A-1024'],
], ['idempotency_key' => bin2hex(random_bytes(16))]);

echo $sr->id . ' ' . $sr->status; // sr_3n8Kd2Qa1V sent

// autoPagingIterator يجلب الصفحات التالية تلقائيًا عبر المؤشّر
foreach ($wt->signatureRequests->all(['status' => 'completed', 'limit' => 100]) as $sr) {
    echo $sr->id . ' ' . $sr->reference . "\n";
}

require 'vendor/autoload.php';

$payload = file_get_contents('php://input');
$sig     = $_SERVER['HTTP_WTHAIQ_SIGNATURE'] ?? '';
$secret  = getenv('WTHAIQ_WEBHOOK_SECRET');

try {
    $event = \Wthaiq\Webhook::constructEvent($payload, $sig, $secret);
} catch (\Wthaiq\Exception\SignatureVerificationException $e) {
    http_response_code(400);
    exit('invalid signature');
}

if ($event->type === 'signature_request.completed') {
    $sr = $event->data->object; // كائن signature_request
    // فعّل الحساب أو خزّن الوثيقة الموقّعة
}
http_response_code(200);