> ## 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 di risposta al pickup via email: Travel Rule > Con Didit, accetta o rifiuta uno scambio Travel Rule da un link di pickup email monouso e fornisci il nome del beneficiario. Prompt di risposta per l'API Email Pickup Copia il prompt negli appunti \

\`Accept or decline a pending Travel Rule exchange from a one-time email pickup link - the counterparty-facing side of Didit's EMAIL fallback rail.

Endpoint:
POST https://verification.didit.me/v3/travel-rule/pickup/{token}/respond/

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

Request body (application/json):
\{"decision": "accept", "beneficiary_name": "Carlos Ruiz"}
or
\{"decision": "decline", "decline_reason": "not_our_customer"}

Optional fields:
\- ivms_response - your full IVMS 101 response (up to 16384 characters); its beneficiary name wins over beneficiary_name.
\- beneficiary_name - up to 255 characters.
\- decline_reason - data_mismatch | not_our_customer | wallet_not_hosted | sanctions | risk_appetite | jurisdiction | insufficient_data | other, or empty (the default) for no reason.
\- decline_detail - up to 512 characters; required when decision is decline and decline_reason is other.
\- contact - the contact the link was sent to, as a UUID; when the body leaves it out, the contact query parameter (the link's ?contact= value) is used.

Behavior:
\- accept - the beneficiary name is run through the originator's name rule: the transfer moves to COMPLETED on a match, COUNTERPARTY_MISMATCHED_DATA otherwise. Supply the name exactly as your records hold it. The response is {"status": "..."}.
\- decline - the transfer moves to COUNTERPARTY_VASP_GENERAL_DECLINE, and the sender's timeline records the reason. The response is {"status": "COUNTERPARTY_VASP_GENERAL_DECLINE", "decline_reason": "..."}.
\- You can answer once: afterwards both pickup endpoints return 410.

Failure modes:
\- 404 - unknown token.
\- 410 - the window closed: the counterparty already answered, the transfer left AWAITING_COUNTERPARTY, or the pickup deadline passed.
\- 400 - decision is missing or is not accept or decline, decline_detail is missing for a decline with reason other, ivms_response is not an IVMS 101 object or is too long, or a contact in the body is not a UUID ({"contact": ["Must be a valid UUID."]}).

Counterparty integration guide: /transaction-monitoring/travel-rule-interoperability#email-pickup.`

\
Incolla in ## OpenAPI ````yaml it/openapi-25.json POST /v3/travel-rule/pickup/{token}/respond/ openapi: 3.0.0 info: version: 3.0.0 title: Didit Verification API description: API di verifica dell'identità. Autenticati con l'intestazione x-api-key. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/travel-rule/pickup/{token}/respond/: post: tags: - Travel Rule summary: Rispondi a una presa in carico tramite canale email description: >- Pubblico, non autenticato. Accetta o rifiuta lo scambio dal link di ritiro inviato via email. In caso di accettazione, beneficiary_name viene verificato rispetto alla policy name_matching_strictness dell'ordinante. operationId: respondTravelRulePickup parameters: - name: token in: path required: true schema: type: string - name: contact in: query required: false schema: type: string description: >- Il valore `?contact=` del link. Utilizzato quando il payload non invia alcun `contact`. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/TravelRulePickupRespondRequest' example: decision: accept beneficiary_name: Carlos Ruiz responses: '200': description: >- Lo stato dello scambio risultante: COMPLETED o COUNTERPARTY_MISMATCHED_DATA dopo un'accettazione, COUNTERPARTY_VASP_GENERAL_DECLINE dopo un rifiuto, che riporta anche `decline_reason`. content: application/json: schema: type: object properties: status: type: string decline_reason: type: string description: Presente dopo un rifiuto. examples: accepted: value: status: COMPLETED declined: value: status: COUNTERPARTY_VASP_GENERAL_DECLINE decline_reason: not_our_customer '400': description: >- Un campo non è valido: ad esempio `decision` mancante o diverso da `accept` o `decline`, `decline_detail` mancante in caso di rifiuto con `decline_reason: other`, una `ivms_response` che non è un oggetto IVMS 101 o supera i 16384 caratteri, oppure un `contact` nel body che non è un UUID (`{"contact": ["Must be a valid UUID."]}`). content: application/json: example: decline_detail: - Say what the reason is when you choose another reason. '404': description: Token sconosciuto. '410': description: >- La finestra si è chiusa: la controparte ha già risposto, il trasferimento ha lasciato lo stato AWAITING_COUNTERPARTY oppure il termine è scaduto. security: - {} x-codeSamples: - lang: curl label: curl source: >- curl -X POST https://verification.didit.me/v3/travel-rule/pickup/{token}/respond/ \ -H 'Content-Type: application/json' \ -d '{"decision": "accept", "beneficiary_name": "Carlos Ruiz"}' components: schemas: TravelRulePickupRespondRequest: type: object required: - decision properties: decision: type: string enum: - accept - decline beneficiary_name: type: string description: >- Il nome del beneficiario registrato nei tuoi archivi, elaborato tramite la regola sui nomi del VASP ordinante. `ivms_response` ha la precedenza se indica il beneficiario. maxLength: 255 decline_reason: type: string enum: - '' - data_mismatch - not_our_customer - wallet_not_hosted - sanctions - risk_appetite - jurisdiction - insufficient_data - other description: >- Il motivo per cui rifiuti. Registrato nella cronologia dei trasferimenti del VASP mittente. Vuoto (valore predefinito) se non indichi alcun motivo. decline_detail: type: string maxLength: 512 description: >- Testo libero; obbligatorio quando `decision` è `decline` e `decline_reason` è `other`. ivms_response: type: object description: >- La tua risposta IVMS 101 completa. Il rispettivo nome del beneficiario ha la precedenza su `beneficiary_name`. contact: type: string format: uuid description: >- Il contatto a cui è stato inviato il link, ricavato dal valore `?contact=` del link. Quando il body lo omette, viene utilizzato il parametro di query `contact`. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.