> ## 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. # حذف المعاملات بالجملة عبر API > احذف المعاملات المراقبة نهائياً في Didit بواسطة UUID، أو امسح كل معاملات التطبيق. لا يمكن الحذف إذا كان التقرير معتمداً. موجّه واجهة برمجة التطبيقات لحذف المعاملات دفعةً واحدة نسخ الموجّه إلى الحافظة \

\`Delete monitored transactions through the Management API.

Endpoint:
DELETE https://verification.didit.me/v3/organization/{organization_id}/application/{application_id}/transactions/delete/

Authentication:
Use the x-api-key header with my Didit API key. The key must carry write:transactions.

Request body — provide one selector:
\{"transaction_uuids": ["abcdef12-3456-7890-abcd-ef1234567890"]}
or
\{"delete_all": true}

Example call:
curl -X DELETE "https://verification.didit.me/v3/organization/{organization_id}/application/{application_id}/transactions/delete/" \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"transaction_uuids": ["abcdef12-3456-7890-abcd-ef1234567890"]}'

Response 204: the selected transactions are deleted.

What is deleted with each transaction:
\- Its parties, tags, notes, payment method links, documents and every stored version of their files.
\- Its rule runs, alerts, provider results, network snapshot and Travel Rule data.
Cases, people and companies stay; their link to the deleted transaction is cleared. Draft regulatory reports stop listing it and are rebuilt without it. Deletion is permanent and cannot be undone.

Failure modes:
\- 400 - no selector supplied: {"transaction_uuids": ["This field is required unless delete_all is true."]}.
\- 409 - at least one selected transaction is listed in a finalized regulatory report. Nothing is deleted. The body has code: in_filed_report and transactions[] with uuid, transaction_id and reports[].
\- 403 - the key cannot delete transactions (requires write:transactions).

After deletion:
Delete the reports named in the 409 response, then repeat this request. See Delete Report.

WARNING — delete_all: true: deletes every transaction in the application with no confirmation and no undo.

For the full integration shape, see /integration/integration-prompt.`

\
الصق في احذف المعاملات الخاضعة للمراقبة نهائيًا، بواسطة UUID أو دفعةً واحدة.## ما الذي يُحذفتُحذف المعاملة مع السجلات الخاصة بها فقط: أطرافها، والوسوم، والملاحظات، وروابط طرق الدفع، والمستندات وكل نسخة مخزّنة من ملفاتها، وعمليات تشغيل القواعد، والتنبيهات، ونتائج المزوّدين، ولقطة الشبكة، وبيانات Travel Rule.تبقى الحالات والأشخاص والشركات، ويُزال ارتباط هذه الكيانات بالمعاملة المحذوفة. تتوقف مسودات التقارير التنظيمية عن ذكر المعاملة المحذوفة وتُعاد إنشاؤها بدونها. الحذف نهائي ولا يمكن التراجع عنه.## اختيار ما يُحذفأرسل محدِّدًا واحدًا فقط:| الحقل | النوع | الوصف | | - | - | - | | `transaction_uuids` | UUID\[] | معرّفات UUID الخاصة بمعاملات Didit المراد حذفها. مطلوب ما لم تكن قيمة `delete_all` هي `true`. | | `delete_all` | boolean | يحذف كل معاملة في التطبيق. يتم تجاهل `transaction_uuids`. |> [!WARNING] > > `delete_all: true` يحذف كل معاملة في التطبيق. لا توجد خطوة تأكيد ولا إمكانية للتراجع.## محظور بسبب تقرير نهائيإذا كانت أي معاملة محددة مدرجة في تقرير تنظيمي نهائي، يعيد الطلب بالكامل الرمز `409` ولا يتم حذف أي شيء:```json theme={null} { "detail": "Transactions included in a filed regulatory report cannot be deleted.", "code": "in_filed_report", "transactions": [ { "uuid": "abcdef12-3456-7890-abcd-ef1234567890", "transaction_id": "your-txn-2026-05-17-001", "reports": [ { "uuid": "5ec00000-0000-4000-8000-000000000007", "report_number": "SAR-0001", "report_type": "SAR", "case_uuid": "c1a5e000-0000-4000-8000-000000000001" } ] } ] } ```احذف كل تقرير باستخدام [حذف التقرير](https://docs.didit.me/ar/management-api/regulatory-reports/delete.md)، ثم أعد تنفيذ هذا الطلب. إذا حددت عدة معاملات، فأزل المعاملات المحظورة أو احذف تقاريرها أولًا.## ذات صلة- [عرض قائمة المعاملات](https://docs.didit.me/ar/management-api/transactions/list.md) - [الحصول على معاملة](https://docs.didit.me/ar/management-api/transactions/get.md) - [حذف التقرير](https://docs.didit.me/ar/management-api/regulatory-reports/delete.md) ## OpenAPI ````yaml ar/openapi-25.json DELETE /v3/organization/{organization_id}/application/{application_id}/transactions/delete/ 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/organization/{organization_id}/application/{application_id}/transactions/delete/: delete: tags: - Transactions summary: حذف المعاملات دفعة واحدة description: >- حذف معاملة واحدة أو أكثر بشكل دائم. حددها باستخدام `transaction_uuids`، أو احذف كل المعاملات في التطبيق باستخدام `delete_all: true`. تُحذف المعاملة المحذوفة مع السجلات الخاصة بها فقط: أطرافها، والوسوم، والملاحظات، وروابط طرق الدفع، والمستندات وكل نسخة مخزنة من ملفاتها، وعمليات تشغيل القواعد، والتنبيهات، ونتائج المزود، ولقطة الشبكة، وبيانات Travel Rule. تبقى الحالات والأشخاص والشركات؛ وتتم إزالة ارتباطها بالمعاملة المحذوفة. تتوقف مسودات التقارير التنظيمية عن إدراجها ويُعاد بناؤها بدونها. الحذف دائم ولا يمكن التراجع عنه؛ ولا يوجد endpoint للتراجع. إذا كانت أي معاملة محددة مدرجة في تقرير تنظيمي نهائي، فسيتم رفض الطلب بأكمله برمز `409` ولن يُحذف أي شيء. يستخدم نص الاستجابة `code: in_filed_report` ويحدد اسم كل معاملة والتقارير التي تدرجها. احذف تلك التقارير، ثم أعد إرسال الطلب. operationId: batch_delete_transactions parameters: - name: organization_id in: path required: true schema: type: string format: uuid description: UUID الخاص بالمؤسسة. - name: application_id in: path required: true schema: type: string format: uuid description: معرّف UUID للتطبيق. requestBody: required: true content: application/json: schema: type: object oneOf: - title: Selected transactions required: - transaction_uuids properties: transaction_uuids: type: array items: type: string format: uuid description: >- معرّفات UUID لمعاملات Didit المطلوب حذفها. مطلوبة ما لم تكن `delete_all` مضبوطة على true. minItems: 1 delete_all: type: boolean enum: - false default: false description: >- اتركه دون إرسال أو أرسل `false` عند تحديد المعاملات باستخدام `transaction_uuids`. - title: All transactions required: - delete_all properties: delete_all: type: boolean enum: - true description: >- حذف كل المعاملات في التطبيق. يتم تجاهل `transaction_uuids`. transaction_uuids: type: array items: type: string format: uuid description: يتم تجاهله عندما تكون قيمة `delete_all` هي true. examples: Selected transactions: value: transaction_uuids: - abcdef12-3456-7890-abcd-ef1234567890 - 12345678-90ab-cdef-1234-567890abcdef All transactions: value: delete_all: true responses: '204': description: تم حذف المعاملات المحددة. '400': description: لم يتم تقديم أي محدد للمعاملة. content: application/json: schema: type: object properties: transaction_uuids: type: array items: type: string example: transaction_uuids: - This field is required unless delete_all is true. '403': description: >- لا يمكن لمفتاح API حذف المعاملات. يتطلب endpoint إذن `write:transactions`. content: application/json: schema: type: object properties: detail: type: string '409': description: >- توجد معاملة محددة واحدة على الأقل مدرجة في تقرير تنظيمي نهائي. لم يتم حذف أي شيء. content: application/json: schema: $ref: '#/components/schemas/InFiledReportError' security: - ApiKeyAuth: [] x-codeSamples: - lang: curl label: curl (selected transactions) source: >- curl -X DELETE 'https://verification.didit.me/v3/organization/11111111-2222-3333-4444-555555555555/application/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee/transactions/delete/' \ -H 'x-api-key: YOUR_API_KEY' \ -H 'Content-Type: application/json' \ -d '{"transaction_uuids": ["abcdef12-3456-7890-abcd-ef1234567890"]}' - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID # and DIDIT_APPLICATION_ID. client = Didit() client.transactions.batch_delete( body={ "transaction_uuids": ["abcdef12-3456-7890-abcd-ef1234567890", "12345678-90ab-cdef-1234-567890abcdef"], }, ) - lang: javascript label: Node.js source: |- import Didit from "@didit-protocol/sdk-node"; // Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID // and DIDIT_APPLICATION_ID. const didit = new Didit(); await didit.transactions.batchDelete({ transaction_uuids: ["abcdef12-3456-7890-abcd-ef1234567890", "12345678-90ab-cdef-1234-567890abcdef"], }); - lang: java label: Java source: >- import java.util.List; import me.didit.Didit; import me.didit.types.TransactionsBatchDeleteParams; // Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID // and DIDIT_APPLICATION_ID. Didit client = new Didit(); client.transactions().batchDelete(TransactionsBatchDeleteParams.builder() .putAdditionalProperty("transaction_uuids", List.of("abcdef12-3456-7890-abcd-ef1234567890", "12345678-90ab-cdef-1234-567890abcdef")) .build()); - lang: php label: PHP source: |- transactions->batchDelete([ 'transaction_uuids' => ['abcdef12-3456-7890-abcd-ef1234567890', '12345678-90ab-cdef-1234-567890abcdef'], ]); - lang: ruby label: Ruby source: |- require "didit" # Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID # and DIDIT_APPLICATION_ID. didit = Didit::Client.new didit.transactions.batch_delete( body: { transaction_uuids: ["abcdef12-3456-7890-abcd-ef1234567890", "12345678-90ab-cdef-1234-567890abcdef"], } ) - lang: csharp label: .NET source: >- using System; using Didit; // Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID // and DIDIT_APPLICATION_ID. using var client = new DiditClient(); await client.Transactions.BatchDeleteAsync(new TransactionsBatchDeleteParams { TransactionUuids = new string[] { "abcdef12-3456-7890-abcd-ef1234567890", "12345678-90ab-cdef-1234-567890abcdef" }, }); components: schemas: InFiledReportError: type: object description: >- رُفض الحذف لأن البيانات المحددة مدرجة في تقرير تنظيمي نهائي. لم يُحذف أي شيء. احذف التقرير، ثم كرر الطلب. required: - detail - code properties: detail: type: string code: type: string enum: - in_filed_report description: رمز خطأ ثابت لعملية حذف محظورة بسبب تقرير تنظيمي نهائي. reports: type: array items: $ref: '#/components/schemas/FiledRegulatoryReport' description: التقارير التي تمنع حذف شخص أو شركة أو حالة أو جلسة. transactions: type: array items: $ref: '#/components/schemas/FiledReportTransaction' description: المعاملات التي تمنع حذف المعاملة، مع التقارير التي تدرج كل منها. FiledRegulatoryReport: type: object description: تقرير تنظيمي مكتمل يمنع الحذف المطلوب. required: - uuid - report_number - report_type - case_uuid properties: uuid: type: string format: uuid description: معرّف UUID للتقرير. report_number: type: string description: رقم التقرير المعروض في Console (على سبيل المثال، SAR-0001). report_type: type: string enum: - SAR - STR - CTR - TTR - UTR - IFT - CBR - TFR description: نوع التقرير التنظيمي. case_uuid: type: string format: uuid description: الحالة التي ينتمي إليها التقرير. FiledReportTransaction: type: object description: معاملة لا يمكن حذفها لأن تقريراً تنظيمياً نهائياً يدرجها. required: - uuid - transaction_id - reports properties: uuid: type: string format: uuid description: معرّف UUID لمعاملة Didit. transaction_id: type: string description: معرّف المعاملة المقدَّم عند إنشاء المعاملة. reports: type: array items: $ref: '#/components/schemas/FiledRegulatoryReport' description: التقارير المكتملة التي تتضمن هذه المعاملة. 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.