Action Transfer
PATCH
/api/v2/travelrule/transfers/{transfer_id}/{action}
This endpoint is used to change the status of a transfer.
Path Parameters
transfer_id
string
The ID of the transfer. Example: 0663cc41-ef29-7995-8000-2d9b414b3174
True
action
string
The action to be applied. See list of supported actions below.
True
Request Body
retry
boolean
Indicates if transfer request should be updated for resending.
True if action is "reject"
reject_error
string
The rejection error code of the transfer request. See below for the list of error codes.
True if action is "reject"
message
string
Additional information on why transfer request is rejected.
True if action is "reject"
transaction_hash
string
The blockchain transaction hash of the completed crypto transaction.
True if action is "complete"
Understanding Travel Rule Transfer Statuses
The status of a Travel Rule transfer evolves as the transfer progresses through different stages. Importantly, the status can differ depending on the point of view:
Originator’s View - The sender (originator) sees the status reflecting the current action they have completed or are awaiting confirmation on. Beneficiary’s View - The recipient (beneficiary) sees a status representing what is pending on their side, such as needing to review, accept, or reject the transfer.
This dual perspective ensures that each party clearly understands their respective responsibilities at any given stage.
"Rejected" with retry responses will be available in upcoming sprints.
1. User → Originator VASP A: Initiates Withdrawal Request 2. Originator VASP A → Ospree: Create Travel Rule Transfer 3. Ospree → Beneficiary VASP B: Send Travel Rule Message 4. Beneficiary VASP B → Ospree: Respond. Action "accept" or "reject" 5. Ospree → Originator VASP A: Pass Beneficiary Response If "Accepted" 6a. Originator VASP A → Initiate Blockchain Transaction 6b. Originator VASP A → Ospree: Update Transfer respond action "complete" If “Rejected” without retry 6c. Originator VASP A → Customer: Notify Customer of Rejection 6d. Originator VASP A → End: Cancel Withdrawal If “Rejected” with retry 6e. Originator VASP A → Originator VASP A: Repair Travel Rule Data 6f. Originator VASP A → Ospree: Update Transfer. Action "repair" 6g. Ospree → Beneficiary VASP B: Re-send Updated Travel Rule Message 6h. Beneficiary VASP B → Ospree: Respond. Action “accept” 6i. Ospree → Originator VASP A: Forward New Response 6j. Originator VASP A → Initiate Blockchain Transaction 6k. Originator VASP A → Ospree: Update Transfer. Action "complete"
Response
Last updated