> ## 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 de Travel Rule: respondre al Pickup Portal per correu

> Respon al VASP client d'una transferència de Travel Rule per correu electrònic des de l'enllaç de recollida, amb adjunts opcionals. Didit.

Respon a la indicació de l'API de Pickup Portal
Copia el prompt al porta-retalls

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

Enganxa a


## OpenAPI

````yaml ca/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 de verificació d'identitat. Autentica't amb la capçalera x-api-key.
servers:
  - url: https://verification.didit.me
security: []
tags: []
paths:
  /v3/travel-rule/pickup/{token}/messages/:
    post:
      tags:
        - Travel Rule
      summary: Respondre al portal de recollida
      description: >-
        Públic, no autenticat. El VASP contrapart respon en una transferència
        pel canal EMAIL. El mateix cos que els missatges de la transacció; els
        fitxers adjunts han de ser PDF, PNG, JPEG o WebP. El token és
        l'autenticació.
      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: El missatge emmagatzemat.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TravelRuleMessage'
        '400':
          description: >-
            Cos no vàlid, un tipus o mida de fitxer no acceptat, més de 100
            missatges a la transferència o un `reply_to` que no és un missatge
            d'aquesta transferència.
          content:
            application/json:
              schema:
                type: object
              example:
                requested_documents:
                  - Name at least one document the counterparty should send.
        '404':
          description: Token desconegut.
        '410':
          description: L'enllaç de recollida ha caducat o la transferència està tancada.
      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: >-
        Envia-ho com a JSON, o com a multipart/form-data amb els fitxers adjunts
        a `files`.
      properties:
        kind:
          type: string
          enum:
            - MESSAGE
            - DOCUMENT_REQUEST
          default: MESSAGE
        body:
          type: string
          maxLength: 5000
          description: Obligatori per a un MESSAGE tret que s'adjunti un fitxer.
        requested_documents:
          type: array
          items:
            type: string
            maxLength: 255
          maxItems: 10
          description: >-
            Obligatori (almenys un) per a un DOCUMENT_REQUEST, i només permès
            aquí.
        reply_to:
          type: string
          format: uuid
          nullable: true
          description: >-
            Un missatge de la mateixa transferència. Una resposta que conté un
            document satisfà la sol·licitud de document a la qual respon.
        files:
          type: array
          items:
            type: string
            format: binary
          maxItems: 5
          description: Només multipart. Fins a 5 fitxers de 10 MB cadascun.
    TravelRuleMessage:
      type: object
      properties:
        id:
          type: string
          format: uuid
        kind:
          type: string
          enum:
            - MESSAGE
            - DOCUMENT_REQUEST
        direction:
          type: string
          enum:
            - INBOUND
            - OUTBOUND
          description: >-
            `OUTBOUND` és el que ha enviat la part del lector. Al portal de
            recollida, la direcció és des de la part de la contrapart.
        author:
          type: string
          description: >-
            Qui ho ha escrit per la seva banda: el correu electrònic d'un usuari
            de la consola o l'etiqueta d'una clau d'API, o el nom de l'altre
            VASP.
        body:
          type: string
        requested_documents:
          type: array
          items:
            type: string
          description: El que sol·licita un DOCUMENT_REQUEST, en paraules del sol·licitant.
        reply_to:
          type: string
          format: uuid
          nullable: true
        fulfilled_at:
          type: string
          format: date-time
          nullable: true
          description: >-
            S'estableix en una DOCUMENT_REQUEST un cop la resposta conté un
            document.
        attachment:
          $ref: '#/components/schemas/TravelRuleMessageAttachment'
        created_at:
          type: string
          format: date-time
    TravelRuleMessageAttachment:
      type: object
      nullable: true
      description: >-
        El document adjunt a un missatge, emmagatzemat com qualsevol altre
        document de transacció.
      properties:
        uuid:
          type: string
          format: uuid
        label:
          type: string
          nullable: true
        note:
          type: string
          nullable: true
        uploaded_by:
          type: string
          nullable: true
          description: >-
            Qui l'ha adjuntat. Al portal de recollida, un fitxer que hagis
            enviat mostra el teu nom de VASP, mai la persona o la clau d'API que
            hi ha darrere.
        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 de descàrrega de durada limitada.
              original_filename:
                type: string
              file_size:
                type: integer

````

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