> ## Documentation Index > Fetch the complete documentation index at: https://docs.didit.me/llms.txt > Use this file to discover all available pages before exploring further. # إصدار رمز معاملات SDK: مراقبة المعاملات من جهة العميل > أصدر رمزًا قصير الأجل ومحدد النطاق لتتمكن SDKs من Didit من إرسال المعاملات المراقبة مباشرةً من تطبيقك. يُفرض ربط الموضوع على الخادم. موجّه API لـ Mint SDK Transaction Token نسخ الموجّه إلى الحافظة \

\`Mint a short-lived scoped token that lets the Didit SDKs submit monitored transactions directly from an end-user's device.

Endpoint:
POST https://verification.didit.me/v3/transactions/sdk-token/

Authentication:
Use the x-api-key header with my Didit API key. This call runs on YOUR BACKEND only - the API key must never ship in an app. Only the returned sdk_token travels to the device.

Goal:
\- Get an sdk_token scoped to one end user (vendor_data). The app passes it to the SDK's submitTransaction method (or directly to POST /v1/transactions/ via the X-Transaction-Token header).
\- The token binds the subject identity server-side: every transaction submitted with it has its subject forced to the token's vendor_data, so a tampered client cannot submit on behalf of another user.

Request body (application/json):
\{
"vendor_data": "user-042",   // required - your internal id for the end user
"ttl_seconds": 900,          // optional - default 900 (15 min), max 86400 (24 h)
"max_uses": 3                // optional - max successful submissions; omit for unlimited within the TTL
}
camelCase aliases (vendorData, ttlSeconds, maxUses) are also accepted.

Example call:
curl -X POST "https://verification.didit.me/v3/transactions/sdk-token/" \
-H "x-api-key: YOUR_API_KEY" -H "Content-Type: application/json" \
-d '{"vendor_data":"user-042","ttl_seconds":900,"max_uses":3}'

What to read from the response:
\- sdk_token - hand this to your app; it authenticates POST /v1/transactions/ via the X-Transaction-Token header.
\- expires_at - ISO-8601 expiry; mint a fresh token per user session rather than reusing long-lived ones.

Failure modes:
\- 400 - missing vendor_data or invalid ttl_seconds/max_uses.
\- 401 - missing or malformed x-api-key.

Best practice:
\- Mint per user session, keep max_uses tight when the number of expected submissions is known.
\- A 401 from POST /v1/transactions/ whose detail contains the word "expired" means the token aged out - mint a new one and retry.

For the full client-side submission guide, see /transaction-monitoring/sdk-transaction-submission.`

\
الصق في ## OpenAPI ````yaml ar/openapi-25.json POST /v3/transactions/sdk-token/ openapi: 3.0.0 info: version: 3.0.0 title: Didit Verification API description: API التحقق من الهوية. قم بالمصادقة باستخدام الرأس x-api-key. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/transactions/sdk-token/: post: tags: - Transactions summary: إصدار token لمعاملات SDK description: >- إصدار token محدد النطاق وقصير الأجل يُمرره تطبيقك إلى حزم SDK الخاصة بـ Didit حتى تتمكن من إرسال المعاملات مباشرة من جهاز المستخدم النهائي عبر `POST /v1/transactions/`. يكون الـ token مرتبطًا بـ `vendor_data` واحد (معرّف المستخدم لديك): يتم فرض هوية موضوع كل معاملة تُرسل باستخدامه من جانب الخادم بناءً على هذا الارتباط، حتى لا يتمكن أي عميل متلاعب به من الإرسال نيابة عن مستخدم آخر. أصدر الـ tokens من واجهتك الخلفية - لا تقم أبدًا بتضمين مفتاح API نفسه داخل التطبيق. تُقبل أيضًا الأسماء البديلة بصيغة camelCase (`vendorData`، و`ttlSeconds`، و`maxUses`). operationId: createTransactionSdkToken requestBody: required: true content: application/json: schema: type: object properties: vendor_data: type: string description: >- معرّفك الداخلي للمستخدم النهائي الذي يقتصر عليه هذا الـ token. يُفرَض كهوية الموضوع لكل معاملة تُقدَّم باستخدام الـ token. example: user-042 ttl_seconds: type: integer default: 900 maximum: 86400 description: >- عمر token بالثواني. القيمة الافتراضية هي 900 (15 دقيقة)؛ والحد الأقصى 86400 (24 ساعة). max_uses: type: integer nullable: true description: >- الحد الأقصى لعدد عمليات الإرسال الناجحة المسموح بها باستخدام token هذا. احذفه أو استخدم null للاستخدام غير المحدود خلال فترة الصلاحية (TTL). required: - vendor_data example: vendor_data: user-042 ttl_seconds: 900 max_uses: 3 responses: '201': description: >- الـ token الذي تم إنشاؤه. مرّر `sdk_token` إلى تطبيقك؛ فهو يُجري المصادقة لـ endpoint الخاصة بـ `/v1/transactions/` المواجهة للجهاز عبر رأس `X-Transaction-Token` حتى `expires_at`. content: application/json: schema: type: object properties: sdk_token: type: string description: token المعاملة محدد النطاق لتمريره إلى SDK. expires_at: type: string format: date-time description: وقت توقف قبول token. example: sdk_token: q7Zt...urlsafe expires_at: '2026-07-07T12:15:00Z' '400': description: >- فشل التحقق: حقل `vendor_data` مفقود، أو `ttl_seconds` خارج النطاق المسموح به. content: application/json: examples: Missing vendor_data: value: vendor_data: - This field is required. '403': description: مفتاح API مفقود أو غير صالح أو ملغى. content: application/json: examples: Invalid API Key: value: detail: Invalid API Key. security: - ApiKeyAuth: [] x-codeSamples: - lang: curl label: curl source: >- curl -X POST https://verification.didit.me/v3/transactions/sdk-token/ \ -H 'x-api-key: YOUR_API_KEY' -H 'Content-Type: application/json' \ -d '{"vendor_data": "user-042", "ttl_seconds": 900, "max_uses": 3}' - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY. client = Didit() result = client.transactions.create_sdk_token( vendor_data="user-042", ttl_seconds=900, max_uses=3, ) print(result) - lang: javascript label: Node.js source: |- import Didit from "@didit-protocol/sdk-node"; // Reads DIDIT_API_KEY. const didit = new Didit(); const result = await didit.transactions.createSdkToken({ vendor_data: "user-042", ttl_seconds: 900, max_uses: 3, }); console.log(result); - lang: go label: Go source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\nresult, err := client.Transactions.CreateSDKToken(ctx, didit.TransactionsCreateSDKTokenParams{\n\tVendorData: \"user-042\",\n\tTTLSeconds: didit.Int(900),\n\tMaxUses: didit.Int(3),\n})\nif err != nil {\n\tlog.Fatal(err)\n}\nfmt.Printf(\"%+v\\n\", result)" - lang: java label: Java source: >- import me.didit.Didit; import me.didit.types.TransactionsCreateSdkTokenParams; // Reads DIDIT_API_KEY. Didit client = new Didit(); var result = client.transactions().createSdkToken(TransactionsCreateSdkTokenParams.builder() .vendorData("user-042") .ttlSeconds(900L) .maxUses(3L) .build()); System.out.println(result); - lang: php label: PHP source: |- transactions->createSdkToken([ 'vendor_data' => 'user-042', 'ttl_seconds' => 900, 'max_uses' => 3, ]); print_r($result->toArray()); - lang: ruby label: Ruby source: |- require "didit" # Reads DIDIT_API_KEY. didit = Didit::Client.new result = didit.transactions.create_sdk_token( vendor_data: "user-042", ttl_seconds: 900, max_uses: 3 ) puts result.to_h - lang: csharp label: .NET source: >- using System; using System.Text.Json; using Didit; // Reads DIDIT_API_KEY. using var client = new DiditClient(); var result = await client.Transactions.CreateSdkTokenAsync(new TransactionsCreateSdkTokenParams { VendorData = "user-042", TtlSeconds = 900, MaxUses = 3, }); Console.WriteLine(JsonSerializer.Serialize(result)); components: securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- مفتاح API الخاص بتطبيقك، من Developers -> API keys في Business Console. يمتلك المفتاح الأساسي وصولاً كاملاً. يمكن تحديد نطاق المفتاح المسمى: لا شيء، أو قراءة، أو كتابة لكل مورد، ومحدوداً ببعض مسارات العمل أو بالجلسات المقبولة، وبقائمة من عناوين IP، وبتاريخ انتهاء الصلاحية. يشير 401 إلى أن المفتاح غير صحيح أو ملغى أو منتهي الصلاحية؛ ويشير 403 إلى أنه لم يتم إرسال أي مفتاح، أو أن المفتاح ليس لديه حق الوصول إلى هذا المورد أو الإجراء، أو أن الطلب جاء من عنوان خارج قائمة عناوين IP الخاصة به؛ ويشير 404 في مسار جلسة إلى أن الجلسة خارج مسارات العمل أو الحالات الخاصة بالمفتاح. يتلقى المفتاح الذي لا يمتلك حق الوصول إلى الوسائط عناوين URL للصور ومقاطع الفيديو وملفات PDF كـ null، ويتلقى المفتاح الذي لا يمتلك إذن كتابة للجلسات روابط الجلسة وtoken كـ null. راجع https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.