> ## 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.

# Travel Rule: الرد عبر قناة البريد في بوابة الاستلام - API

> اكتب رداً من رابط الاستلام إلى VASP الطرف المقابل في تحويل Travel Rule عبر البريد الإلكتروني، مع مرفقات اختيارية من Didit.

الرد في موجّه API لـ Pickup Portal
نسخ الموجّه إلى الحافظة

<pre>
  \`Write back to the customer VASP of an EMAIL-rail Travel Rule transfer from the pickup link.

  Endpoint:
  POST [https://verification.didit.me/v3/travel-rule/pickup/\{token}/messages/](https://verification.didit.me/v3/travel-rule/pickup/\{token}/messages/)

  Authentication:
  None - the one-time pickup link token is the credential.

  Request body (JSON, or multipart/form-data with files): the same fields as the transaction's messages endpoint (kind, body, requested\_documents, reply\_to, files). Attachments must be PDF, PNG, JPEG or WebP.

  Failure modes:

  * 400 - invalid body, a file type that is not accepted, 100 messages reached, or reply\_to is not a message of this transfer.
  * 404 - unknown token.
  * 410 - the pickup link expired or the transfer is closed.

  Full guide: /transaction-monitoring/travel-rule#messages-and-document-requests.\`
</pre>

الصق في


## OpenAPI

````yaml ar/openapi-25.json POST /v3/travel-rule/pickup/{token}/messages/
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/travel-rule/pickup/{token}/messages/:
    post:
      tags:
        - Travel Rule
      summary: الرد في بوابة الاستلام
      description: >-
        عام وغير مصادق عليه. يرد VASP الطرف المقابل على تحويل عبر مسار EMAIL.
        نفس محتوى رسائل المعاملة؛ يجب أن تكون المرفقات بتنسيق PDF أو PNG أو JPEG
        أو WebP. يُعد الـ token وسيلة المصادقة.
      operationId: createTravelRulePickupMessage
      parameters:
        - name: token
          in: path
          required: true
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TravelRuleMessageCreateRequest'
            example:
              kind: MESSAGE
              body: Attached is the proof of address of the wallet holder.
          multipart/form-data:
            schema:
              $ref: '#/components/schemas/TravelRuleMessageCreateRequest'
      responses:
        '201':
          description: الرسالة المخزنة.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TravelRuleMessage'
        '400':
          description: >-
            جسم الطلب غير صالح، أو نوع الملف أو حجمه غير مقبول، أو وجود أكثر من
            100 رسالة في التحويل، أو `reply_to` لا يمثل رسالة تابعة لهذا
            التحويل.
          content:
            application/json:
              schema:
                type: object
              example:
                requested_documents:
                  - Name at least one document the counterparty should send.
        '404':
          description: token غير معروف.
        '410':
          description: انتهت صلاحية رابط الاستلام أو تم إغلاق التحويل.
      security:
        - {}
      x-codeSamples:
        - lang: curl
          label: curl
          source: >-
            curl -X POST
            https://verification.didit.me/v3/travel-rule/pickup/{token}/messages/
            \
              -H 'Content-Type: application/json' \
              -d '{"kind": "MESSAGE", "body": "Attached is the proof of address of the wallet holder."}'
components:
  schemas:
    TravelRuleMessageCreateRequest:
      type: object
      description: أرسل كـ JSON، أو كـ multipart/form-data مع وضع المرفقات في `files`.
      properties:
        kind:
          type: string
          enum:
            - MESSAGE
            - DOCUMENT_REQUEST
          default: MESSAGE
        body:
          type: string
          maxLength: 5000
          description: مطلوب لـ MESSAGE ما لم يتم إرفاق ملف.
        requested_documents:
          type: array
          items:
            type: string
            maxLength: 255
          maxItems: 10
          description: مطلوب (واحد على الأقل) لـ DOCUMENT_REQUEST، ومسموح به هناك فقط.
        reply_to:
          type: string
          format: uuid
          nullable: true
          description: >-
            رسالة خاصة بالتحويل نفسه. الرد الذي يتضمن مستنداً يلبي طلب المستند
            الذي يجيب عليه.
        files:
          type: array
          items:
            type: string
            format: binary
          maxItems: 5
          description: >-
            للطلبات متعددة الأجزاء فقط. ما يصل إلى 5 ملفات بحجم 10 ميغابايت لكل
            منها.
    TravelRuleMessage:
      type: object
      properties:
        id:
          type: string
          format: uuid
        kind:
          type: string
          enum:
            - MESSAGE
            - DOCUMENT_REQUEST
        direction:
          type: string
          enum:
            - INBOUND
            - OUTBOUND
          description: >-
            `OUTBOUND` هو ما أرسله طرف القارئ نفسه. في بوابة الاستلام، يكون
            الاتجاه من جانب الطرف المقابل.
        author:
          type: string
          description: >-
            من كتبه من جانبه: البريد الإلكتروني لمستخدم لوحة التحكم أو تسمية
            مفتاح API، أو اسم VASP الآخر.
        body:
          type: string
        requested_documents:
          type: array
          items:
            type: string
          description: ما يطلبه DOCUMENT_REQUEST، بكلمات صاحب الطلب.
        reply_to:
          type: string
          format: uuid
          nullable: true
        fulfilled_at:
          type: string
          format: date-time
          nullable: true
          description: يُعيَّن على DOCUMENT_REQUEST بمجرد أن يتضمن الرد عليه مستنداً.
        attachment:
          $ref: '#/components/schemas/TravelRuleMessageAttachment'
        created_at:
          type: string
          format: date-time
    TravelRuleMessageAttachment:
      type: object
      nullable: true
      description: المستند المرفق بالرسالة، والمخزن مثل أي مستند معاملة آخر.
      properties:
        uuid:
          type: string
          format: uuid
        label:
          type: string
          nullable: true
        note:
          type: string
          nullable: true
        uploaded_by:
          type: string
          nullable: true
          description: >-
            من أرفقه. في بوابة الاستلام، يُظهر الملف الذي أرسلته اسم VASP الخاص
            بك، ولا يُظهر مطلقاً الشخص أو مفتاح API الذي يقف وراءه.
        created_at:
          type: string
          format: date-time
        files:
          type: array
          items:
            type: object
            properties:
              uuid:
                type: string
                format: uuid
              file_url:
                type: string
                nullable: true
                description: رابط URL محدد الصلاحية زمنيًا للتنزيل.
              original_filename:
                type: string
              file_size:
                type: integer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.