> ## 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. # Responder à retirada por e-mail: API da Travel Rule > Aceite ou recuse uma troca da Travel Rule no Didit via link de e-mail de uso único, com o nome do beneficiário para a checagem de nome do remetente. Prompt da API para responder a uma retirada por e-mail Copiar o prompt para a área de transferência \

\`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.`

\
Colar em ## OpenAPI ````yaml pt-br/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 de verificação de identidade. Autentique-se com o cabeçalho x-api-key. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/travel-rule/pickup/{token}/respond/: post: tags: - Travel Rule summary: Responder a uma coleta pelo canal de e-mail description: >- Público, sem autenticação. Aceita ou recusa a troca a partir do link de coleta enviado por e-mail. Ao aceitar, beneficiary_name é verificado conforme a política name_matching_strictness do remetente. operationId: respondTravelRulePickup parameters: - name: token in: path required: true schema: type: string - name: contact in: query required: false schema: type: string description: >- O valor `?contact=` do link. Usado quando o corpo não envia `contact`. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/TravelRulePickupRespondRequest' example: decision: accept beneficiary_name: Carlos Ruiz responses: '200': description: >- O status resultante da troca: COMPLETED ou COUNTERPARTY_MISMATCHED_DATA após uma aceitação, COUNTERPARTY_VASP_GENERAL_DECLINE após uma recusa, que também retorna `decline_reason`. content: application/json: schema: type: object properties: status: type: string decline_reason: type: string description: Presente após uma recusa. examples: accepted: value: status: COMPLETED declined: value: status: COUNTERPARTY_VASP_GENERAL_DECLINE decline_reason: not_our_customer '400': description: >- Um campo é inválido: por exemplo, `decision` ausente ou diferente de `accept` ou `decline`, `decline_detail` ausente em uma recusa com `decline_reason: other`, um `ivms_response` que não é um objeto IVMS 101 ou tem mais de 16384 caracteres, ou um `contact` no corpo que não é um 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 desconhecido. '410': description: >- O prazo terminou: a contraparte já respondeu, a transferência saiu de AWAITING_COUNTERPARTY ou o prazo-limite passou. 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: >- O nome do beneficiário conforme consta nos seus registros, processado pela regra de nomes do VASP remetente. `ivms_response` tem precedência quando nomeia o beneficiário. maxLength: 255 decline_reason: type: string enum: - '' - data_mismatch - not_our_customer - wallet_not_hosted - sanctions - risk_appetite - jurisdiction - insufficient_data - other description: >- Por que você recusa. Registrado na linha do tempo da transferência do VASP remetente. Vazio (o padrão) quando você não informa um motivo. decline_detail: type: string maxLength: 512 description: >- Texto livre; obrigatório quando `decision` é `decline` e `decline_reason` é `other`. ivms_response: type: object description: >- Sua resposta IVMS 101 completa. O nome do beneficiário nela prevalece sobre `beneficiary_name`. contact: type: string format: uuid description: >- O contato para o qual o link foi enviado, a partir do valor `?contact=` do link. Quando o corpo não o informa, é usado o parâmetro de consulta `contact`. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.