Complete return asset transfer

POST

/positions/{position_id}/returns/{return_id}:completeAssetTransfer

Manually replay the borrower-to-lender asset transfer saga step for a position return.

Request

Path Params

Responses

🟢200

application/json

Headers

Bodyapplication/json

🟠401

🟠403

🟠424

🟠429

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://tokenet-ng-api.digitalprimetechnologies.co/positions/7c9e6679-7425-40de-944b-e07fc1f90ae7/returns/31e0e2d4-5615-4c52-a36d-ecf3f65ad1db:completeAssetTransfer'

Response Example

200 - Success

{
    "return": {
        "asset": "BTC",
        "asset_price_usd": "50000.00",
        "asset_transfer_status": "PENDING",
        "borrower_organization_id": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
        "collateral_asset": "USDC",
        "collateral_price_usd": "1.00",
        "collateral_release_quantity": "12500.00",
        "collateral_release_status": "PENDING",
        "contract_id": "550e8400-e29b-41d4-a716-446655440000",
        "correlation_id": "0f8fad5b-d9cb-469f-a165-70867728950f",
        "create_time": "2026-03-03T12:00:00Z",
        "current_step": "VALIDATE_ASSET",
        "id": "0f8fad5b-d9cb-469f-a165-70867728950e",
        "lender_organization_id": "6ba7b811-9dad-11d1-80b4-00c04fd430c8",
        "position_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
        "position_update_status": "PENDING",
        "principal_repayment_fraction": "0.250000000000000000",
        "quantity": "0.25",
        "return_type": "PARTIAL",
        "status": "INITIATED",
        "update_time": "2026-03-03T12:00:00Z"
    }
}

Modified at 2026-06-16 11:15:56

Create position return

Release return collateral